Open topic with navigation

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

# FUSSEL

You can use the FUSSEL exec to perform detailed inquiry on a Platform Server request.

## Required Parameter

The following table lists the required parameter of the FUSDEL exec:

Parameter | Description
--- | ---
TRANSN | TRN | Defines the fully qualified transaction number (10 bytes) associated with the request.

## Optional Parameters

The following table lists the optional parameters of the FUSSEL exec:

Parameter | Description
--- | ---
CONFIG | CFG | Defines the configuration file used by the Platform Server exec. If this parameter is not defined, the Platform Server REXX uses the default configuration.
QUEUE | Defines the Platform Server to write all of the request fields back onto the REXX external data queue. User execs can then read the external data queue and report on it by using user defined REXX code. Note: This option is normally set only when the FUSSEL exec is called from a user REXX exec.
REPORT | Defines the Platform Server to create a report to display the request fields. You can specify REPORT to display the most important fields about a transfer, or specify `REPORT=LONG` to display all of the fields associated with a transfer request.

## Return Codes

The return codes of the FUSSEL exec are as follows:

- A zero return code indicates that the Platform Server has found the request and displayed fields from the request.
- Non-zero return codes indicate one of the following situations:

  - The Platform Server cannot find the request to be selected on the active queue or the history file.
  - The user is not authorized to select the Platform Server request identified by the TRANSNUM parameter.
  - The request was in a state that cannot be selected, such as LOGGING.
  - A communication error occurred when performing the task.

## Example

Member POSTPROC of the Platform Server EXECS library shows the following example of how the FUSSEL exec can be called with the QUEUE parameter from within a user REXX exec. This exec also shows how the user exec can process data in the REXX external data queue.

    FUSSEL TRN=IA21500006

The output of the example is as follows:

    retncode===> 0 PGTF3101I Activity IA21500006 successfully transferred 25603
     records with remote node 190.190.190.100

    FUSSEL TRN=IA21500006 REPORT

The output of the example is as follows:

    transnum............ =  IA21500006
    remote.system.name.. =  190.190.190.100
    dsn................. =  ACCT.TESTFILE
    status.............. =  COMPLETE
    Remote.file.name.... =  ACCT.TEST.FILE3
    local.user.......... =  ACCTUSER
    remote.userid........=  WINUSER1
    transfer type....... =  SEND
    status.............. =  COMPLETE
    time.completed...... =  09:42:21
    date.completed...... =  2008.294
    process............. =  REXXPROC
    last.message........ =  PGTF3101I Activity IA21500006 successfully transferred 25603
                            records with node 190.190.190.100
    record.count........ =  000000025603
    byte.count.......... =  000002073701
    retncode===> 0 PGTF3101I Activity IA21500006 successfully transferred 25603 records
                 with remote node 190.190.190.100

    FUSSEL TRN=IA21500006 REPORT=LONG

The output of the example is as follows:

    transnum............ =  IA21500006
    remote.system.name.. =  190.190.190.100
    dsn................. =  ACCT.TESTFILE
    Remote.file.name.... =  ACCT.TEST.FILE3
    local.user.......... =  ACCTUSER
    remote.userid........=  WINUSER1
    recfm............... =  VB
    transfer type....... =  SEND
    maxrecl..............=  04100
    effect.............. =  CREATE/REPLACE
    status.............. =  COMPLETE
    avail................=  IMMEDIATE
    time.eligible....... =    :  :
    date.eligible....... =      .
    time.started........ =  09:41:59
    date.started........ =  2008.294
    time.completed...... =  09:42:21
    date.completed...... =  2008.294
    priority............ =
    userdata............ =
    chkintvl............ =  000000
    chkpt.count......... =  000000
    process............. =  REXXPROC
    expdt............... =  2008324
    retry.limit......... =  00001
    tries............... =  00001
    last.message........ =  PGTF3101I Activity IA21500006 successfully transferred 25603
                                      records with remote node 190.190.190.100
    xfer.type........... =  FILE
    record.count........ =  000000025603
    byte.count.......... =  000002073701
    compressed.byte.count=  000000000000
    logon.domain........ =
    translation......... =  BINARY
    crlf................ =  NONE
    compress.type....... =  NONE
    notify.type......... =
    notify.user......... =
    file.avail.......... =  IMMEDIATE
    compress.ratio...... =
    application.type.... =  ALL
    status.............. =  COMPLETE
    ip.port............. =  46464
    retncode===> 0 PGTF3101I Activity IA21500006 successfully transferred 25603 records
                             with remote node 190.190.190.100

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