StorageTek 6 Manual Do Utilizador

Página de 718
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. 
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.