Appendix C. Automated Operations

Many organizations have to automate file transfer processes. In some cases, the data that is transferred must be further processed at the remote side.

Many software packages for the host can scan for certain Write To Operator (WTO) messages and perform different transactions based on the contents of the WTO message.

To automate file transfer processes, certain z/OS messages are required to be standardized. To interface with these automation packages, the Platform Server has standardized several messages that are issued for every transaction.

The following four messages are common to all transactions. The information denoted by the brackets ({ }) are replaceable parameters.

Start of Transfer

The following message is issued at the start of every transfer.

PGTF3100 {Send/Receive} Activity {Transaction_Number} Started to Remote Node {Remote_Node}

 Where:

  • Send/Receive: The direction of the dataset on the host system.
    For example, if you are sending a file from a Windows system to the host, then the direction that must be specified is receive.
  • Transaction_Number: The number that is assigned to the transfer.
  • Remote_Node: The destination to which you are sending or from which you are receiving files.

Completion of Transfer

The message PGTF3108I is issued at the completion of all file transfer activity. This message can be used for automated processing or scheduling.

Successful Completion

PGTF3108I Transfer {Activity#} successfully transferred {Record_Count} records with node:

{Remote_Node}{Byte_Count}(Bytes} or {Remote_Node}{Member_Count} {Members}

Where:

  • Activity#: The number that is assigned to the transfer.
  • Record_Count: The number of records sent or received by the transaction.
  • Remote_Node: The destination to which you are sending or from which you are receiving (This can be displayed as an LU name, IP name, or IP address.)
  • Byte_Count: The number of bytes transferred (uncompressed) for a sequential file.
  • Member_Count: The number of members processed for PDS/Library transfers.

 

PGTF3108I {Activity#} RC={Return_Code} {Remote_Node} {Local_DSN} {Process} Record Count={Record_Count} {S/R} {Userdata}

Where:

  • Activity#: The number that is assigned to the transfer.
  • Return_Code: The number that is returned at the completion of a file transfer. A successful transfer has a return code of all zeroes. An unsuccessful file transfer issues a return code that helps the user determine the specific nature of the problem.
  • Remote_Node: The destination to which you are sending or from which you are receiving. This can be displayed as an LU name, IP name, or IP address.
  • Local_DSN: The name of the local dataset for the transaction. The dataset name must be a valid z/OS dataset and cannot exceed 54 characters in length. If the dataset provided is invalid, the interface prompts the user for a valid name.
  • Process: An 8-character field intended to provide a description of the transaction being processed.
  • Record_Count: The number of records sent or received by the transaction.
  • S/R: The direction of the dataset on the host system. For example, if you are sending a file from the Windows system to the host, then the direction that must be specified is receive.
  • Userdata: The data entered by the user on the process DESCRIPTION parameter.

Unsuccessful Completion

PGTF3109I Activity {Activity#} unsuccessful with Node {Remote_Node} Return Code={Return_Code} error type ERROR

Where:

  • Activity#: The number that is assigned to the transfer.
  • Remote_Node: The destination to which you are sending or from which you are receiving files.
  • Return_Code: The number that is returned at the completion of a file transfer. A successful transfer has a return code of all zeroes. An unsuccessful file transfer issues a return code that helps the user determine the specific nature of the problem.
  • Error_Type: The type of error that caused the transfer to fail.

 

PGTF3108I {Activity#} RC={Return_Code} {Remote_Node} {Local_DSN} {Process} Record Count={Record_Count} {S/R} {Userdata}

Where:

  • Activity#: The number that is assigned to the transfer.
  • Return_Code: The number that is returned at the completion of a file transfer. A successful transfer has a return code of all zeroes. An unsuccessful file transfer issues a return code that helps the user determine the specific nature of the problem.
  • Remote_Node: The destination to which you are sending or from which you are receiving.
  • Local_DSN: The name of the local dataset for the transaction. The dataset name must be a valid z/OS dataset and cannot exceed 54 characters in length. If the dataset provided is invalid, the interface prompts the user for a valid name.
  • Process: An 8-character field intended to provide a description of the transaction being processed.
  • Record_Count: The number of records sent or received by the transaction.
  • S/R: The direction of the dataset on the host system. For example, if you are sending a file from the Windows system to the host, then the direction that must be specified is receive.
  • Userdata: The data entered by the user on the process DESCRIPTION parameter.