Note on usage
Function: Change the property of requests
User group: FT user and FT administrator
Functional description
With the ftmodr command, you can change the priority of requests you have issued, or of a group of requests, for example all the requests to a particular partner. Furthermore, you have the option of changing the order of requests within a priority.
As the FT administrator, you can change the priority of all requests in the system.
Format
ftmodr -h |
[ -ua=<user ID> | -ua=@a ]
[ -pn=<partner 1..200>]
[ -fn=<file name 1..512> ]
[ -pr=n | -pr=l ][ -qp=f | -qp=l ]
[ <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 modified. As a user, you can omit this specification since you may only enter your own user ID.
user ID
As FT administrator, you may specify any user ID here.
@a
As FT administrator, you can specify @a to modify requests relating to all user IDs.
-ua= not specified
Your own user ID is the selection criterion. Exception: you called the command as FT administrator and also specified a request ID: in this case, the presetting is @a.
-pn=partner
You use -pn to specify a name or an address for the partner system for which you want to modify requests. The partner should be specified in the same way as in the request or as it is output in the ftshwr command without the option -s, -l or -csv. If openFT finds a partner in the partner list that corresponds to the specified partner address then ftshwr indicates the name of the partner even if a partner address was specified on request entry.
-fn=file name
You use -fn to specify the file name for which requests are to be modified. Requests which access this file in the local system are modified.
You must specify the file name that was used when the request was created. This file name is also output by the ftshwr command without the -fn option.
Wildcards may not be used in the file name.
-pr=n | -pr=l
indicates the new priority. The following values are possible:
n (normal)
the request has the priority "normal".
l (low)
the request has the priority "low".
-qp=f | -qp=l
indicates the position of the request within the same priority. The following values are possible:
f (first)
the request is placed at the top of the list of requests with the same priority.
l (last)
the request is placed at the bottom of the list of requests with the same priority.
request ID
request ID is used to specify the identification of a specific request that is to be modified. The request ID is output on the screen when reception of the request is confirmed. It can also be displayed using the ftshwr command.
If you have specified a request ID but the other specified selection criteria do not match the request then the request is not modified and the following error message is output:
ftmodr: Request request ID not found