Note on usage
Function: Display request properties and status
User group: FT user and FT administrator
Functional description
The ftshwr ("show requests") command allows you to request information about FT requests. You can specify selection criteria in order to obtain information about specific FT requests.
Users can only obtain information about the requests they own.
The FT administrator can obtain information about the requests of any owner.
Format
ftshwr -h |
[ -ua=<user ID> | -ua=@a ]
[ -ini=l | -ini=r | -ini=lr | -ini=rl ]
[ -st=a | -st=w | -st=l | -st=c | -st=f | -st=h | st=s ][ -pn=<partner 1..200> ]
[ -fn=<file name 1..512> ]
[ -gid=<global request identification 1..4294967295> ][ -s | -l ][ -csv ]
[ <request ID 1..2147483647> ]
Description
-h
Displays the command syntax on the screen. Entries after the -h are ignored.
-ua=user ID | -ua=@a
You use -ua to specify the user ID for which requests are to be displayed.
user ID
As a user, you can only specify your own user ID.
As an FT administrator, you may specify any user ID here.
@a
As an FT administrator, you can specify @a to display requests for all user IDs.
-ua= not specified
Your own user ID is the selection criterion.
Exception: The FT administrator has called the command and also specified a request ID: in this case, the presetting is @a.
-ini=l | -ini=r | -ini=lr | -ini=rl
You use -ini to specify the initiator for which you want to display requests. The following specifications are possible:
l (local)
Only locally submitted requests are displayed.
r (remote)
Only remotely submitted requests are displayed.
lr, rl (local + remote)
Both locally and remotely submitted requests are displayed.
-ini not specified
The initiator is not the selection criterion (corresponds to lr or rl).
-st=a | -st=w | -st=l | -st=c | -st=f | -st=h | -st=s
If you specify -st then only information on requests with the corresponding status is output.
The following specifications are possible:
a (active)
The request is currently being executed.
w (wait)
The request is waiting to be executed.
l (locked)
The request is locked.
c (cancelled)
The request has been deleted.
f (finished)
The request has already been executed.
h (hold)
The starting time specified on the issue of the request has not yet been reached.
s (suspend)
The request was interrupted, i.e. it is currently in the SUSPEND status.
-pn=partner
You use -pn to specify a name or an address for the partner system for which you want to display requests. The partner should be specified as on request submission or as output by the ftshwr command without the -s, -l or -csv option. If openFT finds a partner in the partner list for a specified partner address then ftshwr displays the name of the partner even if a partner address was specified at the time the request was entered.
-fn=file name
You use -fn to specify the file name for which requests are to be displayed. Requests that access this file in the local system are displayed.
You must specify the file name that was used when the request was issued. This file name is also output by the ftshwr command without the -fn option.
Wildcards are not permitted in the file name.
-gid=global request identification
With -gid, you specify the global request ID for a specific request that is to be displayed. The global request ID is only relevant for inbound requests from openFT and FTAM partners. It is assigned by the initiator of the request (transfer ID) and is sent to the local system.
-gid= not specified
The global request ID is not used as a selection criterion.
-s (sum)
specifies that a summary overview of requests is to be output. For each possible request status (see the -st option), this overview indicates the number of requests that have this status.
-l (long form)
specifies that the request properties are to be output in full.
-csv
Specifies that the request properties are to be output in CSV format. If you also specify -s then the summary overview is output in CSV format. The values in the overview are output separated by semicolons.
-s, -l and -csv not specified
The request attributes are output in standard form.
request ID
request ID specifies the identification of a specific request that is to be output. The request ID is output on the screen on acknowledgment of receipt of the request. It can also be viewed, for example, using the ftshwr -l command.
If you have specified a request ID and the other specified criteria do not correspond to the request then the request is not displayed and the following error message is output:
ftshwr: Request request ID not found