CL Command Reference - ADDNETJOBE
CL Command List > ADDNETJOBE Reference
Description:
The Add Network Job Entry (ADDNETJOBE) command adds a network job entry to the network job table on the system. The network job entry is used to determine the action that is taken when a input stream is sent to a user on this system using the Submit Network Job (SBMNETJOB) command.
This entry determines whether the input stream is automatically submitted, placed on the queue of network files for a user, or rejected. The entry also specifies the user profile that is used for checking the authority to the job description referred to by the input stream. There must be one entry for each user or distribution group who intends to submit jobs to this system. There is a network attribute, JOBACN (Job Action), that provides overall control of network job submission. Its value must be *SEARCH before the network job table is searched for an action. If the network attribute is *REJECT, all incoming jobs are rejected. If the network attribute is *FILE, all incoming network jobs are saved in the user¡¯s queue of network files regardless of any network job entry. The network attribute can be changed with the Change Network Attributes (CHGNETA) command.
Each network job entry is identified by the two-part user ID of the sender. When an input stream arrives, the user ID of the sending user is used to find a network job entry. If no entry is found, the second part of the user ID is used to find an entry, using *ANY for the first part. If this search fails, a search is made using *ANY for both parts of the user ID. If no entry is found, the job is rejected.
Restrictions:
1. This command is shipped with public *EXCLUDE authority.
2. The user must have *ALLOBJ (all object) authority.
3. The internal value for a node identifier may differ from the characters shown by the ADDNETJOBE command depending on the type of work station (language) being used. If the byte-string value specified for the FROMUSRID command parameter does not match the rules for an internal node identifier value, or if it does not match the internal value for any defined node (ignoring case differences), an error may be reported.
Examples:
Example 1: Submitting Input Streams Automatically
ADDNETJOBE FROMUSRID(JOHN SMITH) ACTION(*SUBMIT)
SBMUSER(ANDERSON) JOBQ(QGPL/QPGMRL)
This command adds a network job entry that is used to determine the action that is taken for any input stream received from a user with a user ID of JOHN SMITH. The input streams are submitted automatically. User profile ANDERSON is used to check the authority to the job queues and job descriptions specified in the input stream. Messages are sent to the message queue specified in the user profile of the user to whom the input stream was sent. If no job queue is specified in either the received BCHJOB command or the referenced job description, the jobs are placed on job queue QPGMRL in the QGPL library.
Example 2: Sending Messages to Specific Message Queue
ADDNETJOBE FROMUSRID(*ANY JONES) ACTION(*FILE)
MSGQ(BROWN) SBMUSER(ANDERSON)
This command adds a network job entry that is used to determine the action taken for any input stream received from any user with JONES as the second part of the user ID for whom there is not a specific network job entry. The input stream is placed on the queue of received files for the user to whom the job was sent, and a message is sent to message queue BROWN.