Job Execution Result Notification

You can notify the remote host of the execution result of a startup job. The service name is HULSNDRC.

To issue a job status notification, you must incorporate the Job Execution Result Notification program (XRSNDRC) at the end of the JCL for the startup job.

Job Execution Result Notification Program (XRSNDRC)

Program Name

XRSNDRC

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) 
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

Use an editor or similar program to create JCL and definition cards.

Define the definition card from column 1.

Format of definition card

HHost name

This card defines the notification destination host name.

Define an alphanumeric string within 50 bytes for this card.

MMessage

This card defines the message to be sent. Define the message within 70 bytes in a single line.

CStatus code

This card defines the status code to be sent.

Define a numeric string within 4 digits for the Status code.

Defaulting this card sends '0000.'

Definition Example

HMSP1 
MHULJOB  NORMAL  ENDED 
C0000

Example of JCL

JCL for successful job

//HULJOB   JOB  CLASS=A,MSGCLASS=B                                              
//STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR                                         
  :                                                                             
  :                                                                             
USER DEFINED JOB STEP                                                           
  :                                                                             
  :                                                                             
//HULSNDRC EXEC PGM=XRSNDRC                                                     
//XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                              
//XRFILE   DD   DSN=HULFT.FILE,DISP=SHR                                         
//XRHOST   DD   DSN=HULFT.HOST,DISP=SHR                                         
//IPGET    DD   DSN=HULFT.HOSTS.LOCAL,DISP=SHR                                  
//*SYSTCPD  DD  DSN=TCPIVP.TCPPARMS(TCPDATA),DISP=SHR                           
//XRCARD   DD   *                                                               
HMSP1                                                                           
MHULJOB NORMAL ENDED                                                            
C0000                                                                           
/*                                                                              
//

'USER DEFINED JOB STEP' represents a job that the user defines.

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

JCL for unsuccessful job

//HULJOB   JOB  CLASS=A,MSGCLASS=B                                              
//STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR                                         
  :                                                                             
  :                                                                             
USER DEFINED JOB STEP                                                           
  :                                                                             
  :                                                                             
//HULSNDRC EXEC PGM=XRSNDRC,COND=(0,GT)                                         
//XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                              
//XRFILE   DD   DSN=HULFT.FILE,DISP=SHR                                         
//XRHOST   DD   DSN=HULFT.HOST,DISP=SHR                                         
//IPGET    DD   DSN=HULFT.HOSTS.LOCAL,DISP=SHR                                  
//*SYSTCPD  DD  DSN=TCPIVP.TCPPARMS(TCPDATA),DISP=SHR                           
//XRCARD   DD   *                                                               
HMSP1                                                                           
MHULJOB ABNORMAL ENDED                                                          
C000C                                                                           
/*                                                                              
//

'USER DEFINED JOB STEP' represents a job that the user defines.

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