SJ - Starting a session with a DD name or path

The calling application identifies the program object either directly by a UNIX path name or indirectly by the name of a DD statement which identifies either a UNIX path or one or more partitioned data sets. The application may also provide a member name.

Table 1. SJ parameter list
Parameter	Usage	Format	Content
1	in	structure	'SJ', X'0001'
2	in/out	binary word	mtoken Must contain zero when the service is called. The service will supply a value if the service is successful.
3	in	vstring	DD name or path If the string data begins with a slash or a period followed by a slash it is treated as a path, otherwise as a DD name.
4 (optional)	in	vstring	Member name or path extension If parameter 3 is a DD name defining a PDSE or concatenation this is a member name and is required. If parameter 3 is either a path or a DD name defining a path, this parameter is optional and is appended to the path name if present.

Sample assembler code

         CALL  (15),(SJIL,MTOKEN,UNIXDD),VL
*        Note: 4th optional parameter omitted here

SJIL     DC    C'SJ',X'0001'
MTOKEN   DC    F'0'          Replaced by the service
UNIXDD   DC    H'5','UPATH'  Name of a DD statement,
*                            which in turn has PATH.