The parse parameter list
The parse parameter list (PPL) is an eight-word parameter list containing addresses required by the Parse Service Routine.
You can use the IKJPPL DSECT, which is provided in SYS1.MACLIB, to map the fields in the PPL. Table 1 shows the format of the parse parameter list.
Note: The Parameter Control List (PCL) has a size limit of 65,535 bytes. If the PCL is bigger than
the limit, then the parsing routine does not process the command correctly. The PCL starts with the
IKJPARM macro and ends with the IKJENDP macro.
| Offset dec(Hex) | Number of bytes | Field name | Contents or meaning |
|---|---|---|---|
| 0(0) | 4 | PPLUPT | The address of the user profile table. |
| 4(4) | 4 | PPLECT | The address of the environment control table. |
| 8(8) | 4 | PPLECB | The address of the command processor's event control block. The ECB is one word of storage, which must be declared and initialized to zero by your Command Processor. |
| 12(C) | 4 | PPLPCL | The address of the parameter control list (PCL) created by your Command Processor using the parse macro instructions. Use the label on the IKJPARM macro instruction as the symbolic address of the PCL. |
| 16(10) | 4 | PPLANS | The address of a fullword of virtual storage, supplied by the calling routine, in which the Parse Service Routine places a pointer to the parameter descriptor list (PDL). If the parse of the command buffer is unsuccessful, parse sets the pointer to the PDL to X'FF000000'. |
| 20(14) | 4 | PPLCBUF | The address of the command buffer. |
| 24(18) | 4 | PPLUWA | A user supplied work area that parse passes to validity checking routines. This field can contain anything that your Command Processor needs to pass to a validity checking routine. |
| 28(1C) | 4 | PPLVEWA | A user supplied work area that parse passes to verify exit routines. This field can contain anything that your Command Processor needs to pass to a verify exit routine. |