IBM Support

Connect:Direct for Unix gets parsing error XPAE003I when using MGMTCLAS

Troubleshooting


Problem

XPAE003I is occurring when submitting a process on Connect:Direct for UNIX

Symptom

Error on process below. XPAE003I Return Code: 8 Feedback: 0 :&KEYWD=MGMTCLAS:

The process is attempting to use z/OS parameter MGMTCLAS as shown below:

STEP01 COPY FROM (PNODE FILE=/xxxt/etrnos/cronist)
TO (FILE=tste0.test.ttemp7
DISP=(,CATLG,DELETE)
DCB=(DSORG=PS,RECFM=FB,
LRECL=700,BLKSIZE=0)
MGMTCLAS=XXXXXXXX
SPACE=(trk,(1,5),RLSE));

Cause

MGMTCLAS is not a valid keyword for Connect:Direct for UNIX (nor any non-z/OS Connect:Direct).

SMS parameters must be specified on the SYSOPTS when going from UNIX or Windows to z/OS, not as keyword.

Resolving The Problem

To code any SMS file parameter a SYSOPTS statement must be used, as shown below:

STEP01 COPY FROM (PNODE FILE=/xxxt/etrnos/cronist)
TO (FILE=tste0.test.ttemp7
DISP=(,CATLG,DELETE)
DCB=(DSORG=PS,RECFM=FB,
LRECL=700,BLKSIZE=0)
SPACE=(trk,(1,5),RLSE)


SYSOPTS=’MGMTCLAS=XXXXXXXX’
);

Please review the SMS Support section of the IBM Sterling Connect:Direct Process Language Reference Guide which states:


    For platforms other than z/OS, all SMS parameters must be specified as subparameters in SYSOPTS. SYSOPTS is a mechanism that allows you to pass system-specific parameters between platforms. See the COPY statement of the appropriate platform for syntax requirements for the SYSOPTS parameter.

[{"Product":{"code":"SSKTYY","label":"IBM Sterling Connect:Direct for UNIX"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"--","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"4.2;4.1;4.0;3.8","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSFGBN","label":"IBM Sterling Connect:Direct for z\/OS"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
24 July 2020

UID

swg21679253