Previous Topic: The $JCLERR MacroNext Topic: The $JCLPRTN Macro


The $JCLGETM Macro

This macro invokes CA JCLCheck storage management routines to allocate an area of storage. The address of the $JCLGETMed area is returned in register 1.

All storage CA JCLCheck dynamically obtains is by using GETMAINs in 4096-byte units in z/OS subpool 5, and FREEMAIN only when CA JCLCheck terminates. CA JCLCheck suballocates these page size storage units according to $JCLGETM requests, with CA JCLCheck requiring an z/OS GETMAIN only when it needs another page for a $JCLGETM requesting more than 4088 bytes. (CA JCLCheck uses the first eight bytes of each block for control information.) This approach greatly improves execution speed and simplifies storage management for you of $JCLGETM.

This macro has the following format:

$JCLGETM 	LEN=value/(reg),SP=subpoolname

You must specify the SP operand, which provides the disposition of storage as follows:

$SPSTMT

Frees at end of current statement.

$SPSTEP

Frees at end of current step.

$SPPROC

Frees at end of current proc.

$SPJOB

Frees at end of current job.

$SPPERM

Frees when CA JCLCheck terminates.