Supra Modules

In this section:

This topic discusses the pertinent modules for the Adapter for Supra.


Top of page

x
Module CFDP4001

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.


Top of page

x
Module CFDP4002

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.


Top of page

x
Module CFDP4003

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:

qualif

Is the high-level qualifier for the server production libraries.

qualif.TOTAL.LOAD

Is the name of the adapter load library.

cincom

Is the high-level qualifier for the Supra libraries supplied by Cincom.


iWay Software