CPCLOSE (Control Program File Close) Macro
The macro can be used in spooling programs written in Basic Assembler Language.
It causes a CPCLOSE command to be issued to VM in order to release a print or punch file for output.
Format
Requirements for the caller
- AMODE:
- 24
- RMODE:
- 24
- ASC Mode:
- Primary
Parameters
- parmlist | (r1)
- This operand specifies a 16-byte parameter list. The format of
the list is described below. In your program, you must set up the
list before you issue the macro. If the parameter list name is specified,
the system loads the address into register 1. If a register is specified,
it is assumed to contain the address of the parameter list and this
address is loaded into register 1. If no operand is specified, register
1 is assumed to contain the address of the parameter list. The format
of this list is:
- Bytes
- Contents
- 0-1
- Always 0.
- 2-3
- Device address in hexadecimal format.
- 4-7
- Device address in EBCDIC format.
- 8-15
- Job name (left justified).
Assume the device at address 280 is to be closed and the name of the job is JOB. The parameter list then contains:00 00 02 80 F0 F2 F8 F0 D1 D6 C2 40 40 40 40 40
Return Codes in Register 15
- 00
- Successful completion of CPCLOSE macro.
- 04
- Device is invalid, no CLOSE is issued.
- 08
- Supervisor not running under VM.