What you need to do to use the Parse Service Routine

This section gives a step-by-step description of what you must do to use the Parse Service Routine. The sections that follow provide more detailed information on each of the major steps.

Follow these steps when using the Parse Service Routine:

Define the syntax of the operands of the command or subcommand. This topic is discussed in Defining command operand syntax.
Use the parse macro instructions to build the parameter control list (PCL) that describes the command or subcommand operand syntax. The parse macro instructions are described in Using the parse macro instructions to define command syntax.
- Use the IKJPARM macro instruction to begin the parameter control list (PCL).
- Use the appropriate parse macro instructions to build the parameter control entries (PCEs) that parse will use to check the syntax of the operands.
- Use the IKJENDP macro instruction to indicate the end of the parameter control list (PCL) for the command or subcommand.
Provide installation exits for operand checking (optional).
- Write validity checking routines to do additional checking on positional operands. See Using validity checking routines for a discussion of this topic.
- Write verify exit routines to check unidentified keyword operands or unidentified keyword operands within a subfield. See Using verify exit routines for a discussion of this topic.
Pass control to the Parse Service Routine. See Passing control to the Parse Service Routine.
Check the return code passed by the Parse Service Routine in general register 15. Return codes are listed in Checking return codes from the Parse Service Routine.
Examine the results of the scan of the command buffer returned by parse in the parameter descriptor list (PDL). See Examining the PDL returned by the Parse Service Routine for a description of the PDEs returned by parse.