This general macro causes the next card to be read into the specified
storage block from the specified card reader. A 128-byte storage block
is obtained by the service routine if no block is supplied by the application
program.
Format
- label
- A symbolic name can be assigned to the macro statement.
- level
- A symbolic data level must be specified. Range D0-DF.
- cardrdr
- The 3-character symbolic name of the card reader must be specified for the
available card reader. Specify one of the following:
Entry Requirements
- R9 must contain the address of the entry control block (ECB) being
processed.
- No other ECB may be using the specified card reader.
- The USURC macro must have been previously called by this program
requesting the assignment of the specified card reader to this ECB.
- If no storage block is held at the specified level, a 128-byte block will
be retrieved by the service routine.
Return Conditions
- Control is returned to the next sequential instruction.
- The contents of R14 and R15 are unknown. The contents of all other
registers are preserved across this macro call.
- The status of the Read operation is unknown. A WAITC macro must be
executed to ensure completion of the operation.
- The file address reference word (FARW) at the specified level is
unchanged.
- The contents of the core block reference word (CBRW) at the specified
level is unknown.
Programming Considerations
- This macro can be executed on any I-stream.
- The macro service ensures that the specified device is assigned to this
ECB. If it is not, the abort switch is set on in the gross and detail
error indicators in the ECB (CE1SUG/CE1SUD) and the request is not
serviced.
- To ensure completion of the Read operation, a WAITC macro must be issued
before attempting to use the expected record. The storage block is not
available until the WAITC completes. When control is returned to the
operational program after the WAITC, the condition code and systems
error/unusual condition indicators in the ECB will indicate the status of all
completed I/O operations. For errors associated with the card reader,
the CE1SUD for the specified level and CE1SUG are set as follows:
- The user need not provide a CCW command code for this I/O
operation. The macro service routine provides the command code of Read,
Feed and Select Stacker 1.
- The macro service routine uses the data definition UR0IO to determine
where the data read will be stored. Using the storage address supplied,
or storage obtained by the service routine as the base of UR0IO, data is read
into UR0TXT. The card will be read and stacked into stacker 1.
Examples
None.