In this section: |
This topic discusses the pertinent modules for the Adapter for Supra.
The CFDP4001 module is a load module developed for support of the adapter multi-session facility. This module is LINKEDITed with the name CSTEDBMI. Since this is the same name as the current Cincom single task and central region module, you must place 'qualif.TOTAL.LOAD', the data set that contains this module, ahead of the LINKLIB and ENVLIB load libraries supplied by Cincom. This module is self contained and is not a composite module like the other CSTEDBMI modules. Make sure not to overlay another Cincom adapter.
The CFDP4002 module is a reusable module that provides the link to the adapter's multi-session facility. It must be linked as reusable so that only one copy is in the address space. The CFDP4001 module loads it when the first PDM request is processed. This module loads the multi-session adapter module (CSTEDBMI) and establishes the connection with the Central PDM. It reads the input parameters to determine the number of task and concurrent operations to be supported during the session. Any errors found will generate a console message. Depending on the error, the connection may be terminated.
The CFDP4003 module is a security module that provides the exit for controlling access to the PDM data resources. It is loaded by module CFDP4002 when the input parameters specify the SECURITY= keyword. It loads the named user module, calls the module using standard IBM calling conventions (register 1 points to the parameter list and register 13 points to the register save area), and passes a security block to the user module.
On return from the called security module, the status field is examined. The operation is accepted if the status field is "****". Any other value results in termination of the operation with a status of "SECR". The user security module may not issue any calls to the PDM. The security block passed to the module is:
Security Block Passed | |||
---|---|---|---|
Field Name |
Field Format and Values |
Field Length |
Starting Position |
USERID |
Character |
8 |
1 |
ACCESS |
Character (R=Read, W=Write) |
1 |
9 |
DDNAME |
Character |
4 |
10 |
DSNNAME |
Character |
44 |
14 |
STATUS |
Character (****=ACCESS ALLOWED) |
4 |
58 |
The library containing these modules should be concatenated to the STEPLIB DD of the server JCL ahead of the LINKLIB and ENVLIB supplied by Cincom. For example,
//STEPLIB DD DSN=qualif.TOTAL.LOAD,DISP=SHR // DD DSN=cincom.ENVLIB,DISP=SHR // DD DSN=cincom.LINKLIB,DISP=SHR
where:
Is the high-level qualifier for the server production libraries.
Is the name of the adapter load library.
Is the high-level qualifier for the Supra libraries supplied by Cincom.
iWay Software |