SEND User's Guide November 1989 This document describes how to use the SEND software to submit IBM JCL Batch jobs for execution and control routeback of RJE output. Supersession/Update Information: This is a new manual. Operating System and Version: VMS V4.6 and later Software Version: SEND V2.0 SEND SEND Submits IBM JCL files to the corporate IBM system for execution. If the /OUTPUT qualifier is specified, it will also create entries in the system RJE routeback queue. These entries specify routeback information for printer output received from the IBM system. FORMAT SEND file-spec[,...] PARAMETER file-spec[,...] Specifies the name of an existing JCL file to be submitted to the corporate IBM system for execution. Use a plus sign (+) or a comma (,) to indicate multiple file specifications. Wildcards are not allowed. DESCRIPTION The SEND command submits a file (or files) containing IBM JCL commands and data to the VMS/SNA Remote Job Entry (RJE) system for execution. As such, it functions in an identical manner to SUBMIT/SNA. However, its primary purpose is to allow the submitter to specify how the resulting RJE output file(s) should be handled. To properly route RJE output, the JOB card of the JCL job must specify a room identifier that corresponds to the submitter's username. In a typical VMS environment using LASTNAME_FM as the username, the room code would be the user's initials. See the SEND/INITIALS command to determine what is expected to be the room code for any general username. When routeback is specified by use of the /OUTPUT qualifier, the room code must be correct or the job will not be submitted. If no routeback is specified, the room code is not checked and so can be omitted or used for other purposes. In this case, SEND file-spec is analogous to SUBMIT/SNA file-spec. SPECIFYING ROUTEBACK RJE output can be routed to one of the following locations: · A directory or file. The username of the submitter must have write access to this location. · Any print queue. Any qualifiers used by the PRINT command may be specified. · One or more mail addresses. · A VMS batch job. The name of the routeback file is passed as the first parameter to the batch job. QUALIFIERS /AFTER=time Requests that the job be held until after a specific time. If the specified time has already passed, the job is queued for immediate processing. You may specify an absolute time, delta time, or a combination of the two. /DELETE Specifies that the JCL file(s) should be deleted after successful submission to the IBM system. /LOG Specifies that the entry of routeback information in the system routeback queue be logged to the terminal. /NOTIFY Specifies that notification messages should be sent to the username associated with the routeback entry. A notification is broadcast when submission of the JCL to the IBM system is completed. A notification is also broadcast when routeback occurs for each RJE output file. /OUTPUT=output-type=output-specification Specifies that routeback should occur for all RJE print output for this job. The routeback method and destination is required. Note that routeback is based upon a match of the jobname and the room code in the JOB card: // jobname JOB (accting,room..... ^^^^^^^ ^^^^ Note that once routeback is specified (by use of the /OUTPUT qualifier), the effect is permanent unless the /TEMPORARY qualifier is specified. Use the SEND/REMOVE command to remove old entries. Use the SEND/RT command to view the current routeback queue for your username. output-type FILE=file-spec Specifies that the output should be copied to the file given by the file-spec. Note that the username associated with the routeback entry must have write-access to the specified directory for this routeback to function properly. SPOOL="print-qualifiers" Specifies that RJE output should be printed with the print qualifiers specified. In particular /QUEUE=queue-name can be used to direct output to a user-specified queue. The BATCH="file-spec[batch-qualifiers]" Specifies that the file specified should be submitted for batch execution. Parameter P1 will be defined for the batch job as the filename of the RJE output. If any qualifiers are included, the file-spec should be enclosed in quotes ("). Note that multiple RJE output files will cause multiple submittals to occur. Note also that the batch job is submitted under the username associated with the routeback entry. Use of the /REMOTE qualifier is not supported. MAIL="address[,...]" Specifies that RJE output should be mailed (via VMSmail) to the address(es) specified. /QUEUE=number Specifies that the JCL file(s) should be submitted via reader queue SNARJE$READER. /TEMPORARY Specifies that the routeback entry should be deleted after the first successful routeback of RJE output. EXAMPLES In the following examples, it is assumed that the user entering the SEND commands is logged into username JONES_RK. 1 $ SEND SUMMARY.JCL This example submits the JCl file SUMMARY.JCL to the IBM system for execution. No routeback is specified, so any resulting output will be printed on the default RJE printer. See your system manager for the name of the default printer. 2 $ SEND SUMMARY.JCL/OUTPUT=MAIL=BOSS/NOTIFY In this example, the JCL file SUMMARY.JCL is submitted to the IBM system for execution. Any resulting printer output will be mailed to username BOSS. Also, notification messages will be broadcast to JONES_RK User JONES_RK will be notified when transmission to the IBM system is completed and when each output file is mailed to BOSS. Note that the JOB card must contain RKJ as the room code for the job to be successfully submitted. 3 $ SEND PRELIM.JCL+MONTH.DATA+REPORT.JCL/OUTPUT=FILE=MONTH.RPT/TEMPORARY This example submits a batch job made up of file PRELIM.JCL followed by MONTH.DATA followed by REPORT.JCL to the IBM system for execution. After the output is routed to file MONTH.RPT in JONES_RK's default directory, the routeback entry is deleted. 4 $ SEND T.JCL/OUTPUT=SPOOL="/QUEUE=MAILROOM/FORM=LANDSCAPE/COPIES=2" This command causes two copies of the RJE output to be printed at queue MAILROOM using form LANDSCAPE. Note that the print qualifiers MUST be enclosed in quotes. 5 $ SEND T.JCL/OUTPUT=BATCH=FURTHER-ANALYSIS.COM When RJE output is received, the command file FURTHER-ANALYSIS.COM will be submitted to SYS$BATCH. Parameter P1 will contain the actual filename of the RJE output file. This is equivalent to the DCL command: $ SUBMIT/QUEUE=SYS$BATCH/PARAMETER=("RJE-filename")- FURTHER-ANALYSIS.COM 6 This example illustrates the use of the BATCH output specifier. The JCL file is displayed below: $ TYPE T.JCL // IIDEMO JOB (IYIY1234,RKJ) · · < IBM JCL job > · · // The following command is used to submit the JCL to the IBM system for processing and specifies that the command file MULTI-PRINT.COM should be submitted for execution on the VMS batch queue SYS$BATCH. $ SEND T.JCL/OUTPUT=BATCH=MULTI-PRINT.COM When RJE output is received, the command file MULTI-PRINT.COM will be submitted to SYS$BATCH. Parameter P1 will contain the actual filename of the RJE output file. This is equivalent to the DCL command: $ SUBMIT/QUEUE=SYS$BATCH/PARAMETER=("RJE-filename")- MULTI-PRINT.COM The file MULTI-PRINT.COM looks like the following: $ TYPE MULTI-PRINT.COM $! Print RJE output at several printers $! $ RJE_FILE = P1 ! Get filename of RJE output $! $! Print the output on three-part paper $! $ PRINT/QUEUE=MYPRINTER/FORM=PART3 'RJE_FILE' $! $! Print a copy on my printer for record keeping $! $ PRINT/QUEUE=LASER/COPIES=2/NOFLAG 'RJE_FILE' $! $! Send report to my boss (after converting to plain text) $! $ RJECOPY/STRIP 'RJE_FILE' CLEAN.FILE $ MAIL CLEAN.FILE LARRY /SUBJECT="Monthly summary finished" $! $ EXIT SEND/ENTER SEND/ENTER Creates an entry in the RJE routeback queue for a spe- cific jobname without submitting a job for execution on the IBM system. FORMAT SEND/ENTER jobname [qualifiers...] PARAMETER jobname Specifies the jobname whose routeback entry is being defined to the routeback queue. This is the name of the job as known to the IBM system. Hence, it is limited to eight alphanumeric characters. A single character wildcard (%) may be used for the eighth character. This support is included for those users printing from the IBM system through the RJE system and who can only control the first seven characters of the jobname. DESCRIPTION The SEND/ENTER command is used to add entries to the routeback queue without the necessity of submitting a job for execution. This is usually done on a one-time basis, especially for jobs that are executed on the IBM system on behalf of a VMS user. Routeback is still accomplished by a match of the job's jobname and room code with an entry in the routeback queue. A VMS user holding the OPER privilege can specify any username or room-code. This is most useful when the VMS user cannot control the jobname or room-code of the IBM job. Note that for security reasons, no routeback will occur for a username whose associated UIC is a system UIC. QUALIFIERS /CONFIRM Controls whether a request is issued before the current entry is entered into the routeback queue. The following responses are valid: YES NO /LOG Specifies that the entry of routeback information in the system routeback queue be logged to the terminal. /NOTIFY Specifies that notification messages should be sent to the username associated with the routeback entry. A notification is broadcast when submission of the JCL to the IBM system is completed. A notification is also broadcast when routeback occurs for each RJE output file. /OUTPUT=output-type=output-specification Specifies that routeback should occur for all RJE print output for this job. The routeback method and destination is required. Note that routeback is based upon a match of the jobname and the room code in the JOB card: // jobname JOB (accting,room..... ^^^^^^^ ^^^^ Note that once routeback is specified (by use of the /OUTPUT qualifier), the effect is permanent unless the /TEMPORARY qualifier is specified. Use the SEND/REMOVE command to remove old entries. Use the SEND/RT command to view the current routeback queue for your username. output-type FILE=file-spec Specifies that the output should be copied to the file given by the file-spec. Note that the username associated with the routeback entry must have write-access to the specified directory for this routeback to function properly. SPOOL="print-qualifiers" Specifies that RJE output should be printed with the print qualifiers specified. In particular /QUEUE=queue-name can be used to direct output to a user-specified queue. The BATCH="file-spec[batch-qualifiers]" Specifies that the file specified should be submitted for batch execution. Parameter P1 will be defined for the batch job as the filename of the RJE output. If any qualifiers are included, the file-spec should be enclosed in quotes ("). Note that multiple RJE output files will cause multiple submittals to occur. Note also that the batch job is submitted under the username associated with the routeback entry. Use of the /REMOTE qualifier is not supported. MAIL="address[,...]" Specifies that RJE output should be mailed (via VMSmail) to the address(es) specified. /ROOM=room-code Specifies the room to be associated with this routeback entry. The room code is one to four alphanumeric characters. It also can be an asterisk (*), in which case routeback will be controlled by the jobname alone. If not specified, the room-code defaults to the initials of the username (see SEND/INITIALS). You must hold the OPER privilege to use the /ROOM qualifier. /USERNAME=vms-username Specifies a different username to be associated with the routeback entry. You must hold the OPER privilege to use the /USERNAME qualifier. EXAMPLES In the following examples, the username issuing the commands is assumed to be JONES_RK. 1 $ SEND/ENTER MONTHRPT/OUTPUT=SPOOL="/QUEUE=LQP" This example creates a routeback entry for jobname MONTHRPT and room RKJ. Any RJE output whose jobname is MONTHRPT and room is RKJ will be printed at queue LQP. 2 $ SEND/ENTER/ROOM=* MONTHRPT/OUTPUT=MAIL=JONES_RK In this example, any RJE output whose jobname is MONTHRPT will be mailed to username JONES_RK. Note that JONES_RK must hold the OPER privilege to specify /ROOM=* 3 $ SEND/ENTER/LOG/ROOM=* JONESRK%/OUTPUT=FILE=MYOUTPUT.LIS This example will route RJE output to a file named MYOUTPUT.LIS from any job whose jobname is eight characters long and whose first seven characters are JONESRK. SEND/INITIALS SEND/INITIALS Displays the initials corresponding to the room code for a username. FORMAT SEND/INITIALS [qualifier] DESCRIPTION The SEND/INITIALS command is used to display the initials corresponding to the current user's username. These initials must match the room-code specified on the JOB card of JCL that is being submitted for execution on the IBM system. The initials also must match the room-code that is part of the banner of RJE output for routeback to be successful. If the username contains an underscore (_), the initials will be made up of the first two characters after the underscore, followed by the first character of the username. If only one character follows the underscore, the initials will be made up of the first character following the underscore, followed by the first character of the username. If the username contains no underscore, then the first three characters of the username will be used. QUALIFIERS /USERNAME=username Specifies an alternate username whose initials will be displayed. EXAMPLES In the following examples, the username issuing the commands is assumed to be JONES_RK. 1 $ SEND/INITIALS %SEND-I-ROOMCODE, initials (room code) for username JONES_RK = RKJ 2 $ SEND/INITIALS/USERNAME=SMITH_J %SEND-I-ROOMCODE, initials (room code) for username SMITH_J = JS 3 $ SEND/INITIALS/USERNAME=HENDERSON %SEND-I-ROOMCODE, initials (room code) for username HENDERSON = HEN SEND/REMOVE SEND/REMOVE Removes entries from the RJE routeback queue. Requires OPER privilege to remove entry for other username or non-default room-code. FORMAT SEND/REMOVE jobname [qualifiers...] PARAMETER jobname Specifies the jobname whose routeback entry is being removed from the routeback queue. This is the name of the job as known to the IBM system. Hence, it is limited to eight alphanumeric characters DESCRIPTION The SEND/REMOVE command is used to remove an entry from the RJE routeback queue. A VMS user holding the OPER privilege can specify any username or room-code. QUALIFIERS /CONFIRM Controls whether a request is issued before the entry is deleted from the routeback queue. The following responses are valid: YES NO /LOG Specifies that the removal of the routeback entry from the RJE routeback queue be logged to the terminal. /ROOM=room-code Specifies the room-code associated with the routeback entry to be deleted. The room-code is one to four alphanumeric characters. It can also be an asterisk (*). If not specified, the room-code defaults to the initials of the username (see SEND/INITIALS). You must hold the OPER privilege to use the /ROOM qualifier. /USERNAME Specifies a different username than the user's current username. You must hold the OPER privilege to use the /USERNAME qualifier. EXAMPLES In the following examples, the username issuing the commands is assumed to be JONES_RK. 1 $ SEND/REMOVE MONTHRPT This removes the routeback entry whose jobname is MONTHRPT and room-code is RKJ. 2 $ SEND/REMOVE/CONFIRM/LOG MONTHRPT Username = JONES_RK (RKJ ) Jobname = MONTHRPT (Notification = N) Output = MONTHLY.RPT Answer YES to delete this entry? YES %SEND-I-ENTRYREMOVED, following entry removed Username = JONES_RK (RKJ ) Jobname = MONTHRPT (Notification = N) Output = MONTHLY.RPT This example shows both the /CONFIRM qualifier (displays the entry before removal), and the /LOG qualifier (displays the entry after removal). SEND/RT SEND/RT Displays information about current RJE routeback entries. FORMAT SEND/RT [jobname] [qualifiers] PARAMETER jobname Specifies the IBM jobname whose routeback entry should be displayed. DESCRIPTION The SEND/RT command displays routeback entries associated with the specified jobname. If the jobname is omitted, all entries for the given username are displayed. QUALIFIERS /ALL Displays all entries in the routeback queue. /FULL Displays a full listing of each specified entry. By default, the default directory and creation date are not displayed. NOTE: The default directory is no longer used. In a future release, the default directory will be removed from the routeback entry. /LIST=file-spec By default, the output of the SEND/RT command is sent to the current SYS$OUTPUT device (usually your terminal). To send the listing to a file, use the /LIST qualifier followed by a file specification. /USERNAME=username By default, the entries of the current username are displayed. To see the entries of another username, use the /USERNAME qualifier followed by a username. EXAMPLES 1 $ SEND/RT MONTHRPT Listing of RJE routeback queue User = JONES_RK (RKJ ) Jobname = MONTHRPT Room = RKJ Notification = N Output will be mailed to following address(es): JONES_RK,BOSS In this example, the routeback listing for IBM jobname MONTHRPT is displayed to the user's terminal: 2 $ SEND/RT Listing of RJE routeback queue User = JONES_RK (RKJ ) Jobname = MONTHRPT Room = RKJ Notification = N Output will be mailed to following address(es): JONES_RK,BOSS Jobname = PRDRPT Room = RKJ Notification = N Output will be mailed to following address(es): JONES_RK,BOSS In this example the jobname is omitted. Hence, all entries for user JONES_RK are displayed. 3 $ SEND/RT/FULL MONTHRPT Listing of RJE routeback queue User = JONES_RK (RKJ ) Jobname = MONTHRPT Room = RKJ Notification = N Output will be mailed to following address(es): JONES_RK,BOSS Default Directory = DISK$USERS:[JONES_RK] Creation date = 19-DEC-1988 16:06:05.71 This example uses the /FULL qualifier to see all fields of the routeback entry. Note that the default directory is NOT used.