Open topic with navigation

TIBCO® Managed File Transfer Platform Server for z/OS 8.1.0

# 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. Valid values are: `NONE`: No encryption is used for this transfer. `DES`: DES encryption is used. `3DES`: Triple DES encryption is used. `BF`: Blowfish 56-bit encryption is used. `BLOWFISH`: Blowfish 56-bit encryption is used. `BFL`: Blowfish 448-bit encryption is used. `BLOWFISH_LONG`: Blowfish 448-bit encryption is used. `AES`: AES 256-bit encryption is used. 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. Note: This parameter is ignored unless the WAIT parameter is specified.
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`.
PPA | Defines the preprocessing or postprocessing actions that are performed for the file transfer. The format of the PPA command is: `PPA={"S | F |P, L | R, CALLJCL | CALLPGM | SUBMIT | COMMAND data_to_be_processed"}` Where Status is: `S`: Success, `F`: Failure, `P`: Pre-Processing Where Source is: `L`: Local (Initiator), `R`: Remote (Responder) Where Action is: `CALLJCL`: Call program on z/OS with JCL linkage `CALLPGM`: Call program on z/OS with standard linkage `SUBMIT`: Submit job on z/OS `COMMAND`: Execute a command Where Data is: The data to be processed
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. Note: This parameter is ignored unless the WAIT parameter is specified.
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. Note: This exec is only executed when the Platform Server request is purged from the active queue.
RPASS | Defines the password for the user on a remote computer. Note: This parameter can only be defined when the RUSER parameter is also defined.
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. Note: This parameter is ignored unless the WAIT parameter is also specified.
TIME | Defines the start time of the request in 24-hour clock format, hhmm.
TIMEOUT | Defines the timeout interval. Note: This parameter is ignored unless the WAIT parameter is specified.
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

Copyright © 2003-2021. TIBCO Software Inc. All Rights Reserved.