Using ASAM callable interface calls

This section describes how to code ASAM callable interface calls and structures in a PL/I application program.

For more information, see Using-ASAM-services-through-GSAM-replacement.

AR/CTL calls

The following shows how to code the AR/CTL callable interface:

CALL ARCfunc (parmcount, parmlist...);

Call parameters

The following parameters are valid on the AR/CTL callable interface calls.

ARCfunc

Required. The name of the AR/CTL module to handle the call.

parmcount

Required. The address of a 4-byte field that contains the number of parameters in this call, not counting the parmcount parameter.

parmlist

Required. A list of parameters that the application program passes to AR/CTL with the call. The parameters to include in the list depend on the call.

Define the user areas to save in the checkpoint call as part of a structure. It cannot be part of a major structure or a stand-alone value. The length field must be declared as a 31-byte fixed binary field, as shown in the following example:

   DCL 1 WORKAREA,
         3 ULENGTH FIXED BIN(31) INIT(500)

ASAM I/O area

Code the ASAM I/O area according to the following example. The example area contains three character-type fields, which are 4 bytes, 16 bytes, and 32 bytes long, respectively.

DCL 1 ASAMAREA,
      2 ASAMFLD1 CHAR(4),
      2 ASAMFLD2 CHAR(16),
      2 ASAMFLD3 CHAR(32);

ASAM ARB

Code the ARB according to the following example:

DCL 1 ARCARB,
     2 ARCARB-TYPE CHAR(8) INIT('$ARCARB '),
     2 FUNC-CODE   CHAR(8) INIT('READ    '),
     2 DDNAME      CHAR(8) INIT('ddname  '),
     2 STATUS-CODE CHAR(2) INIT('  '),
     2 UNUSED      CHAR(2) INIT('  '),
     2 ULRECL      FIXED BIN(31);

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*