Filter
Top Products
Appendix F. Batch Application Program Interface (API) 633
1st ed., 6/30/04 - 312579601
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.