Description

The HZSCPARS macro provides functions dealing with parsing the check parameter string. It is intended to help only with parsing the parameter area for the check (as opposed to some general area) and it is of help only for parameter area syntaxes that follow a simple style, namely a combination of "PositionalValue" or "keyword=value" or "keyword=value1,...,valuen" or "keyword(value1,...,valuen)" items separated from each other by one or more blanks or a comma. If "PositionalValue" is found, all items must be of that positional format. If keyword/value format is found, no values of positional format are allowed. You should avoid extra separating commas, as two consecutive commas indicates a null positional value.

When HZSCPARS finds a parameter syntax error, as indicated by a return code 0C and reason code HZSCPARSRsn_SyntaxError (xxxx0C01), it issues an appropriate error message for you using one of the REASON=PARSxxxx reason values on the HZSFMSG macro. This means that your check routine does not have to issue error messages for these parameter errors. Note that your check routine must still issue a final HZSFMSG REQUEST=STOP,REASON=BADPARM service call for any such parameter error.