Remote Job Execution

You can execute a job on a remote host by executing the Remote Job Execution request.

When the remote host acknowledges the Remote Job Execution request, the remote host executes the job that the local host defined. The job to be executed must be registered in the Job Information in advance. The service name is HULRJOB.

Remote Job Execution Program (XRRJOBEX)

Program Name

XRRJOBEX

XRSYSIN Definition Card

This card defines the System Environment Settings of HULFT system. For details on the definitions, refer to the following:

HULFT10 for zOS Administration Manual : Explanation of each field

Format of definition card

HOST-NAME=Local Host Name 
DOMAIN=Local Domain Name 
RETRY=Retry Count on Connection Error 
HSTCHA=Case Options for Local Host Name or Local Domain Name 
TIMEOUT=Socket Read Timeout 
TCPIP=Address Space Name of TCP/IP 
OPLSELECT=Operation Log Output Option (*1) 
DATEFMT=Date Format 
SNDSOCKSIZE=Socket Buffer Size for Data Sending 
RCVSOCKSIZE=Socket Buffer Size for Data Receiving 
HULCHARSET=HULFT Character Set

When you use the operation log output function, you must include definitions related to operation logs. For details, refer to Definitions for operation logs.

XRCARD Definition Card

Format of definition card

         a                    b           c           d 
JOBID=xxxxxxxx,EXEC-HOST=xxxxxxxx...xxx[,SYNC [,TIMEOUT=999999]]

= Remarks =

If the definition card spans two lines, use either of the following two methods to define the definition card:

Describe the first line up to column 71, and then insert a hyphen (-) in column 72. Describe the second line starting in column 1.
Describe a line up to a comma (,) that follows a parameter, insert a single byte space, and then insert a hyphen (-) in column 71 or before.

Input contents of definition card

a. Job ID

This parameter defines the job ID of the job to be executed. (Mandatory)

Specify a string of alphanumeric characters (and "_" if desired) that is within 50 bytes.

This job ID must be registered in the Job Information on the remote host.

b. Host name

This parameter defines the name of the remote host on which the job is executed. (Mandatory)

Specify an alphanumeric string within 50 bytes for this parameter.

c. Synchronous execution

This parameter is defined to synchronize the program with the job execution until the end of the job execution on the remote host. (Optional)

Defaulting this parameter ends the program when the program executes the Remote Job Execution request.

d. Time-out for synchronous execution

This parameter defines the time-out for the synchronous job execution in seconds. (Optional)

Define the duration of synchronization during which the local host can receive the result of the job execution from the remote host.

Set a value from '10' to '259200' for this parameter. Defaulting this parameter sets '300.'

To define the time-out for the Synchronous Transfer, you must define 'SYNC.'

Example of JCL

//XRRJOBEX JOB  CLASS=A,MSGCLASS=B                                              
//XRRJOBEX EXEC PGM=XRRJOBEX                                                    
//STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR                                         
//XRFILE   DD   DSN=HULFT.FILE,DISP=SHR                                         
//XRHOST   DD   DSN=HULFT.HOST,DISP=SHR                                         
//XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                              
//IPGET    DD   DSN=HULFT.HOSTS.LOCAL,DISP=SHR                                  
//*SYSTCPD  DD  DSN=TCPIVP.TCPPARMS(TCPDATA),DISP=SHR                           
//SYSOUT   DD   SYSOUT=*                                                        
//XRCARD   DD   *                                                               
JOBID=JOB01,EXEC-HOST=ZOS,SYNC                                                  
//

DD Name	Value	Description
STEPLIB	HULFT.LOAD	HULFT load module library
XRFILE	HULFT.FILE	Send and Receive Management File
XRHOST	HULFT.HOST	Host Information File
XRSYSIN	HULFT.PARMLIB(HULPRM)	System Environment Settings File
IPGET	HULFT.HOSTS.LOCAL	IP Management File
SYSTCPD	TCPIVP.TCPPARMS(TCPDATA)	TCPIP.DATA Data Set

Note

When the requestee-side host runs HULFT for Mainframe (when you want to execute a job that is registered in HULFT for Mainframe), the duration of synchronization that you define for the time-out for synchronous execution, during which the local host can receive the result of the job execution from the remote host, is rounded up to an integer value in minutes.

Example:: If you define '30' for the time-out for synchronous execution, the actual duration of synchronization during which the local host can receive the result of the job execution from the remote host is one minute (60 seconds).

= Remarks =

For details on the acknowledgment results on the host that acknowledges the Remote Job Execution request, refer to the following:

HULFT10 for zOS Error Codes and Messages : Status codes and detail codes for Observe processing