JESINTERFACELEVEL differences

The FTP JESINTERFACELevel 2 allows increased functionality for users over that available with JESINTERFACELevel 1. Jobs allowable by the system (JESSPOOL RACF® class) whether they are in held or nonheld output class can be viewed. Information about jobs such as held/dup for jobs on the internal reader, CPU time of running jobs, and number of sysout data sets for completed jobs can be displayed.

If the user does a DIR subcommand without any operands, the display shows matches of the search criteria — one line per task. If the user does a DIR subcommand for a specific JOBID, the status of the job is listed and, if the status is OUTPUT, it lists information about all the sysout data sets created by this job (and available in the JES spool data set at the time of access). If a JOBID is supplied and the job is active, it lists information about the job step name, cpu busy, and elapsed time.

Whenever a DIR subcommand is executed (with or without arguments), the JESJOBNAME, JESENTRYLIMIT, JESOWNER and JESSTATUS filter keywords can be used to limit the number of entries that are returned to the user. A DIR subcommand with all JES keywords set to their default and JESOWNER set to USER1 returns information about all batch jobs that have USER1 registered as OWNER. If the value of JESOWNER is set to empty (space), it defaults to the logged-in user ID.

To list jobs for all users, a value of JESOWNER=* must be specified. If the value of JESJOBNAME is set to empty (space), it defaults to the logged-in user ID suffixed with an asterisk (if user is USER1, then JESJOBNAME defaults to USER1*).
To list all job names, a value of JESJOBNAME=* must be specified. If the value of JESSTATUS is set to empty, it defaults to all types of output.
To list only the completed jobs, specify a value of JESSTATUS=OUTPUT.

The subcommands DIR, LS, MDELETE, and MGET allow wildcard (*) filtering on a specific jobid only if JESINTERFACELevel 2 is active. A DIR subcommand results in the use of the LIST FTP command. An LS, MDELETE, or MGET subcommand results in the use of the NLST FTP command.

The following table summarizes the behavior of the different levels of JESINTERFACELevel. The term matching filters means all jobs that match parameters of JESJOBNAME, JESOWNER, JESSTATUS, and up to the JESENTRYLIMIT entries.

Subcommand	JESINTERFACELevel 1	JESINTERFACELevel 2
DIR [*]	All jobs	All Jobs matching filters
DIR Jxx	All jobs (Jxx ignored)	Details for Jxx (*)
LS	All jobids	All jobids matching filters
LS Jxx with wildcards	All jobids	All Jobs matching filters (*)
LS Jxx no wildcards	All jobids (Jxx ignored)	All Jxx.nnn sysout ds names matching filters (*)
GET Jxx.1 [local-file]	Return single sysout file	Return single sysout file
GET Jxx.x [local-file]	All Jxx sysout files in one file with separators	All Jxx sysout files in one file with separators
MGET *	One file per job - each file with separators - local file names default to jobids	One file per job matching filters - each file with separators - local files names default to jobids
MGET jxx	As MGET * (Jxx ignored)	One file per job matching filters - each file with separators - local file names default to Jxx.nnn (*)
DELETE Jxx	Jxx deleted	Jxx Deleted
DELETE Jxx.1	Not supported	Not supported
MDELETE *	All jobs deleted	All jobs matching filters deleted
GET jclds outfile	Server jclds submitted, all output returned in outfile with separators	Server jclds submitted, all output returned in outfile with separators

JESINTERFACELevel 2 returns different entries from JESINTERFACELevel 1 with wildcard (*) filtering, assuming the default values are used for the JESOWNER, JESJOBNAME, and JESENTRYLimit plus JESSTATUS=OUTPUT. The format of the returned data might also be different.

FILETYPE=JES parameters on DIR, LS and MGET subcommands allow an asterisk (*) for all job IDs, or a specific job ID. If a job ID is specified, but no such job ID exists, an error reply is returned to the client.

The NLST command is used under the covers for MGET and MDELETE to obtain lists of the resource names to issue individual GET or DELETE subcommands against. For job IDs, the list is simply a list of JES job IDs. For sysout data set IDs, the list is a list of JES job IDs suffixed with sysout data set numbers — in the same syntax that is supported by the GET and DELETE subcommands.

LIST, NLST, MDELETE, and MGET all show different behaviors for JESINTERFACELevel 2 over JESINTERFACELevel 1. This is because LIST and NLST use the filters for JESINTERFACELevel 2, and the commands DIR, LS, MDELETE, and MGET use LIST and NLST.

For job IDs, an NLST command returns:
```
JOB00013
JOB00034
STC00067
```
For sysout data set IDs, an NLST command returns:
```
JOB00013.1
JOB00013.2
JOB00013.3
JOB00013.4
```