ASPC - Enter memory allocation

General

Application area:	Accounting/system administration macro; see "Accounting"
Macro type:	Type S, MF format 1: 31-bit interface: standard/L/D/E form; see "S-type macros"

The ASPC macro can only be called under the TSOS (system administration) ID. An unauthorized call will be rejected with return code X'0C'.

Macro description

The ASPC macro is used to record the current memory allocation on public and private volumes. The PAM page allocation is recorded in the form of accounting records.

The ASPC macro writes one or more accounting records (space stocktaking records: record ID = DSPC or DSPP) to the accounting file for every locally available public volume set (PVS) or private disk (PD). Each record contains the following:

• the catalog ID of the PVS

• time of stocktaking (date, time of day);

• an indicator relating to the completeness of the record:
  'C':     continuation character
  'L':     recording complete ('L' = last)
  'I':     recording incomplete (the PVS was exported during recording)

• user IDs for the PVS (up to 26 user IDs per record);

• number of PAM blocks allocated per user ID;

For a detailed description of DSPC and DSPP records, see the “Accounting records” manual [13 (Related publications)]. Several records are written for one PVS if the PVS has more than 26 user IDs. In this case, the records contain the continuation character.
ASPC has no operands that control functions.

Macro format and description of operands

ASPC

,MF=S / L / (E,..) / D

,P=I / p

MF=
For a general description of the MF operand, its operand values and any subsequent operands (e.g. for a prefix), see "S-type macros". The valid MF values are given at the start of the macro description under “Macro type” and are included in the macro format.
If MF=D, a prefix P (p = 1 letter) can be specified, as shown in the macro format.

Return information and error flags

R15:

+---------------+
|   |   |   |   |
|b|b| | | | |a|a|
+---------------+

A structured return code (aa=primary return code, bb=secondary return code) relating to the execution of the ASPC macro is transferred in register R15.

X'bb'	X'aa'	Meaning
X'00'	X'00'	Normal execution
X'04'	X'00'	The record was not written because accounting or the DSPC record was deactivated
X'00'	X'04'	Address error (operand list)
X'00'	X'08'	Invalid function code (for SVC 99 in the operand list)
X'00'	X'0C'	User is not authorized to call the macro
X'00'	X'10'	System or resource error
X'04'	X'10'	No job information
X'08'	X'10'	Error on accessing MRSCAT
X'0C'	X'10'	Error on accessing the internal USERTABLE
X'10'	X'10'	Error on writing a record

In all cases where aa = X'10' there is also an entry in the SERSLOG file containing the operand list and the return code of the called system function.