z/OS TSO/E Customization
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Writing an exit for the SUBMIT command

z/OS TSO/E Customization
SA32-0976-00

Users issue the SUBMIT command to submit one or more batch jobs for background processing by JES. On the command, users can specify one or more data set names or member names that define an input stream consisting of JCL statements and input data. For information about using the SUBMIT command, see . For information about the syntax of the SUBMIT command, see .

The SUBMIT command processor reads the JCL statements and writes the data set or data sets that the user specifies into an internal reader of the job entry subsystem. When the SUBMIT command processor reads or generates the first JOB statement, it invokes the exit. Note that if TSO/E builds the JOB statement, the PASSWORD and USER parameters are not included on the statement.

By default, only JOB statements and continuations of the JOB statement are passed to the exit. An embedded comment in the JOB statement is, however, passed as part of the JOB statement. By setting different control switches, the exit can indicate to the SUBMIT command processor that it wants to check additional types of JCL statements as the statements are read from the input data sets. For example, the exit can also check EXEC and DD statements.

You can use the SUBMIT exit to check the user ID and job name and accept, reject, or modify the JCL statements that a user submits. The exit can check the JCL statement and either leave it unchanged, change it, or delete it. The exit can continue a statement or add new statements. It can also have the SUBMIT command processor display a message at the user's terminal, request a response from the user, or cancel a SUBMIT request.

The following highlights some ways you can use the SUBMIT exit. For more information, see Possible uses.
  • Cancel a SUBMIT request
  • Process statements in addition to the JOB statement
  • Delete the current JCL statement
  • Add a new statement after the current statement
  • Change the current statement
  • Supply a password on the JOB statement

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014