FUSSCMD
You can use the FUSSCMD exec to queue a request to send a command to a remote partner.
Required Parameters
The following table lists the required parameters of the FUSSCMD exec:
| Parameter | Description |
|---|---|
| REXXEXEC or CALLJCL or CALLPROG or SUBMIT | REXXEXEC: defines a command or exec to be executed on the remote platform. No parameter can be passed to the command.
CALLJCL: defines the name of the program to call, and the parameters that are to be passed to the program. CALLPROG: defines the name of the program to call, and the parameters that are to be passed to the program. SUBMIT: defines the name of the JCL to submit, and any symbolic parameters associated with the JCL. The parameters must be delimited by colons (:) instead of comma (,). |
| IPADDR or IPNAME or LIST or NODE | IPADDR: defines the dotted decimal IP address of the remote platform server node.
IPNAME: defines the IP name of the remote platform server node. It can be up to 24 bytes. LIST: defines the name of the distribution list. NODE: defines the name of the destination node for a request. The LUname is used if NODE is not defined to the platform server. |
Optional Parameters
The following table lists the optional parameters of the FUSSCMD exec:
| Optional Parameters | Description |
|---|---|
| CONFIG | CFG | Defines the configuration file used by the platform server exec.
If this parameter is not defined, the platform server uses the default configuration. |
| DATE | Defines the start date of the request in Julian format, ccyyddd. |
| DESCRIPTION | Defines the user data for the transfer in 25 bytes. |
| EMAIL_FAIL | Defines the email address to which to send an email notification when a request is completed unsuccessfully. |
| EMAIL_GOOD | Defines the email address to which to send an email notification when a request is completed successfully. |
| ENCRYPT | Defines the level of encryption that is used by the transfer.
If specified, this parameter overrides the ENCRYPT parameter specified in the GLOBAL or NODE definitions for this transfer. The valid values are as follows:
For more information on this parameter, see Data Encryption. |
| EXPDT | Defines the expiration date of a file transfer request, in Julian format, CCYYDDD.
The default value is 30 days from now. |
| EXPTM | Defines the expiration time for a file transfer request. |
| INTERVAL | Defines the status scan interval. |
| NOTIFY | Defines the TSO user to notify when the request is completed. |
| NOTIFY_TYPE | Defines a type of user to notify when the request is completed.
Currently, the only option supported is TSO. |
| PROCESS | Defines the process name that is associated with the request. |
| PRIORITY | Defines the priority for file transfers.
The allowable values are 0 - 9. The default value is 3. |
| PRINTER_NAME | Defines the name of a remote printer. |
| PURGE | Defines whether to purge uncompleted transfers when the TIMEOUT interval expires. |
| RETENTIONPRD | Defines the number of days that the platform server leaves a request on an active queue before purging the request.
The allowable values are 1 - 9999. The default value is 30 days. |
| RETRY | Defines the number of times that the platform server tries a request when a network error occurred.
The default value of 1 means that the platform server purges the transfer when the first network error occurs. For best results set this parameter to 1 if you specify the WAIT parameter. |
| RETRYINT | Defines the retry interval of the file transfer.
This parameter can be specified in terms of hours, for example, RETRYINT=2H or minutes, for example, RETRYINT=0M. |
| REXX_EXEC | Defines a REXX exec that will be executed when the platform server request is completed, either successfully or unsuccessfully. |
| RPASS | Defines the password for the user on a remote computer. |
| RUSER | Defines the name of the user on the remote computer.
If this parameter is not defined, the default value *PROFILE is used. |
| SAY | Writes a status record on each status scan. |
| TIME | Defines the start time of the request in 24-hour clock format, hhmm. |
| TIMEOUT | Defines the timeout interval. |
| WAIT | Waits for this request to be completed before returning to REXX. |
Example
The following example shows how to use the FUSSCMD exec to queue a request to send a command to a remote partner:
FUSSCMD NODE=SNANODE SUBMIT=JCL.LIB(ABC123) INTERVAL=3 SAY WAIT
The output of this example is as follows:
TRANSACTION=IA01500042 STATUS=ACTIVE RECORD=000000000 BYTES=000000000 TRANSACTION=IA01500042 STATUS=COMPLETE RECORD=000000000 BYTES=000000000 ***Fusion retcode.......= 0 ***Fusion TransNum......= IA01500042 ***Completed transfers..= 01 ***Successful transfers.= 01 ***Failed transfers.....= 00 ***Purged transfers.....= 00 ***Last Message.........= PGTF3101I Activity IA01500042 successfully transferred 0 records with remote node SNANODE Request Queued successfully with TRANSNUM= IA01500042