HZSLFMSG Output variables

The reason code explaining a return code of 4 or more. The reason codes are as follows:

0000041A

Meaning: Unrecognized pre-defined symbol, or plain & in a DIRECTMSG message.

Action: Use only supported symbols, or use pre-defined symbol & amp ; for a plain & instead.

00000858

Meaning: HZS_HANDLE was not valid.

Action: Make sure that the HZSLFMSG function is only called from a REXX exec called by IBM® Health Checker for z/OS®. The check exec must not modify output variable HZS_HANDLE. If this function is used within a procedure, make sure you used the EXPOSE option to make HZS_HANDLE accessible to the procedure code

00000890

Meaning: HZSLFMSG_REQUEST is not valid.

Action: Make sure HZSLFMSG_REQUEST is set to a valid value. The valid values are 'CHECKMSG', 'HZSMSG' and 'STOP'.

00000891

Meaning: HZSLFMSG_DIAG is not valid.

Action: Make sure the HZSLFMSG_DIAG is set to a valid value:

• An 8 character value that will be displayed as a hexadecimal value.
• A 16 character hexadecimal value, that may contain valid hexadecimal characters: 0-9 and A-F only.

00000892

Meaning: HZSLFMSG_REASON is not valid .

Action: Make sure the HZSLFMSG_REASON is set to a valid value:

• When HZSLFMSG_REQUEST='HZSMSG', the valid values of HZSLFMSG_REASON are: { 'ERROR' | 'PARS1201' | 'PARS1202' | 'PARS1203' | 'PARS1204' | 'PARS1205' | 'PARS1206' | 'PARS1207' | 'PARS1208' | 'PARS1209' | 'PARS1210' | 'PARS1211' | 'PARS1212' | 'PARS1213' | 'PARS1214' | 'PARS1215' | 'PARS1216' | 'PARS1217' | 'PARS1218' | 'PARS1219' }
• When HZSLFMSG_REQUEST='STOP', the valid values of HZSLFMSG_REASON are: { 'BADPARM' | 'ERROR' | 'ENVNA' }

00000893

Meaning: HZSLFMSG_MESSAGENUMBER is not valid.

Action: Make sure the HZSLFMSG_MESSAGENUMBER is set to a valid decimal number that identifies the desired message to be written.

00000894

Meaning: HZSLFMSG_INSERT 0 is not valid .

Action: Make sure the stem variable HZSLFMSG_INSERT 0 is set to the number of message inserts defined for the message that is to be written. The minimum number of message inserts that can be defined for a message is zero (0). The maximum number of inserts that can be defined for a message is twenty (20).

00000895

Meaning: HZSLFMSG_INSERT.xx is not valid .

Action: Make sure HZSLFMSG_INSERT.xx is valid. Each insert is limited to 256 characters. Numeric inserts for PARS12yy messages must be a decimal number between 0 and 999999999. The first 2 characters of HZSFMSG_RSN identifies which insert is not valid.

0000089F

Meaning: HZSLFMSG service issued a 290 ABEND .

Action: Look at the data returned in HZSLFMSG_USERRSN and HZSLFMSG_ABENDRESULT to determine the problem:

HZSLFMSG_USERRSN

290 ABEND reason code (see ABEND Codes).

HZSLFMSG_ABENDRESULT

ABEND result string returned by HZSFMSG service.

000008A0

Meaning: HZSLFMSG_DIRECTMSG_ID is not valid.

Action: Make sure the required HZSLFMSG_DIRECTMSG_ID REXX variable is set to a valid text string which does not exceed the maximum length as documented for the HZSFMSG macro keyword NUM.

000008A1

Meaning: HZSLFMSG_DIRECTMSG_TEXT is not valid.

Action: Make sure the required HZSLFMSG_DIRECTMSG_TEXT REXX variable is set to a valid text string which does not exceed the maximum length as documented for the HZSFMSG macro keyword TEXT.

000008A2

Meaning: HZSLFMSG_DIRECTMSG.EXPLN is not valid.

Action: Make sure the optional HZSLFMSG_DIRECTMSG.EXPLN REXX variable is set to a valid text string which does not exceed the maximum length as documented for the HZSFMSG macro keyword EXPL.

000008A3

Meaning: HZSLFMSG_DIRECTMSG.SYSACT is not valid.

Action: Make sure the optional HZSLFMSG_DIRECTMSG.SYSACT REXX variable is set to a valid text string which does not exceed the maximum length as documented for the HZSFMSG macro keyword SYSACT.