StorageTek 6 manual QCDS Programming Considerations, E,parmaddr, Notes, Ucaladr

Notes:

1.A CDS must be preallocated to ddname in the JCL or in a SVC 99 dynamic allocation request before issuing QCDS requests.

2.The input CDS does not need to be active or referenced by the HSC address space.

3.QCDS allows for multiple input CDSs, as long as each uses a unique ddname and specifies a different token for each open CDS. For example, an application can open two input CDSs and process them in an alternating, or interleaved, fashion.

This parameter is optional. If DDNAME is omitted, QCDS attempts to open the most recently updated CDS specified in the SLSCNTL, SLSCNTL2, or SLSSTBY DDnames for the current job step. If none of these DDnames is defined, QCDS tries to open an active CDS. In this case, the HSC address space must be active or the OPEN fails.

UCALADR

rtnaddr indicates an RX-type fullword location, register (15), or a register (2) - (12) containing the address of the SLSUCAL routine.

This parameter is required. You must load the SLSUCAL module into storage before issuing a QCDS request.

MF

indicates either the list or execute form of the macro.

L

specifies the list form of the macro. This parameter generates a remote parameter list that can be referenced by the execute form of the macro.

Note: When L is specified, all other parameters are ignored.

E,parmaddr

specifies the execute form of the macro. parmaddr is an RX-type address or a register (1) - (12) containing the address of the remote parameter list.

This parameter is required.

QCDS Programming Considerations

•Only one instance of each library element record area can be open for each invocation.

•QCDS does not account for CDS switches for any open input CDS.

•The job step or task should define DDname SYSMDUMP to capture diagnostic information if an internal QCDS error occurs.

•Record order within a library element record area is unpredictable.

Appendix F. Batch Application Program Interface (API) 633

1st ed., 6/30/04 - 312579601