CTRACE - List form

Syntax

The list form of the CTRACE macro is written as follows:

Syntax	Description

`name`	`name`: Symbol. Begin `name` in column 1.

␢	One or more blanks must precede CTRACE.

CTRACE

␢	One or more blanks must follow CTRACE.

,PLISTVER=`xplistver`	`xplistver`: Parameter list version 0, 1, or 2
,PLISTVER=IMPLIED_VERSION	Default: IMPLIED_VERSION
,PLISTVER=MAX	Default: Version that allows all specified parameters

,MF=(L,`cntl)`	`cntl`: Symbol.
,MF=(L,`cntl,attr)`	`attr`: 1- to 60-character input string.
,MF=(L,`cntl`,0D)	Default: 0D.

Parameters

The parameters are explained as follows:

,PLISTVER=(xplistver | IMPLIED_VERSION)

Is an optional one byte input, decimal value in the range of 0 to 2, that specifies the macro version associated with CTRACE. PLISTVER is the only keyword allowed on the list form of the macro. It determines which parameter list is generated.

Note that MAX can be specified instead of a number, and the parameter list will be the largest size currently supported. This size may grow from release to release (thus possibly affecting the amount of storage needed by your program). If your program can tolerate this, IBM® recommends that you always specify MAX when creating the list form parameter list, to ensure that the list form parameter list is always long enough to hold whatever parameters are specified on the execute form. The macro keywords associated with each supported version of the macro are listed below.

Version	Keyword
0	ASID BUFFER DEFINE DELETE DELSUBS FMTTAB IFNOSUBS JOBS MINOPS NAME RC STARTNAM
1	BUFDEFIN BUFDFLT BUFMAX BUFMIN HEAD HEADOPTS LIKEHEAD MANYSUB MOD PARM SSRC SSRSNC SUB USERDATA WTR WTRMODE
2	DISPNAM

,MF=(L,cntl)

,MF=(L,cntl,attr)

,MF=(L,cntl,0D)

Specifies the list form of the macro.

cntl is the name of a storage area for the parameter list.

attr is an optional 1- to 60-character input string, which can contain any value that is valid on an assembler DS pseudo-op. You can use this parameter to force boundary alignment of the parameter list. If you do not code attr, the system provides a value of 0D, which forces the parameter list to a doubleword boundary.