Note on usage
Function: Modify request queue
User group: FT user and FT administrator
Functional description
You use the FTMODREQ command to modify the position and priority of your outbound requests within the openFT request queue. You have the option of processing the outbound requests in any order you wish. Newly input requests or requests whose priority changes are put at the end of the request queue for the corresponding priority. If already active requests are repositioned behind waiting outbound requests, the active requests are interrupted if possible in favor of those waiting.
FTMODREQ is only valid for outbound requests.
The sequence of requests with a starting time in the future cannot be modified.
As FT administrator you can modify all requests.
As FT user you can only modify your own requests.
Format
FTMODREQ |
TRANSFER-ID = *ALL / <integer 1..2147483647> ,SELECT = *OWN / *PARAMETERS(...) *PARAMETERS(...) OWNER-IDENTIFICATION = *OWN / *ALL / <name 1..8> ,PARTNER = *ALL / <text 1..200 with-low> ,FILE = *ALL / <filename 1..59> / <c-string 1..512 with-low> ,QUEUE-POSITION = *UNCHANGED / *FIRST / *LAST ,PRIORITY = *UNCHANGED / *NORMAL / *HIGH / *LOW |
Operands
TRANSFER-ID =
Transfer ID of the outbound request to be modified.
TRANSFER-ID = *ALL
Modifies all outbound requests if further selections haven’t been specified with SELECT (see below). FT users can only modify requests under their own user ID.
TRANSFER-ID = <integer 1..2147483647>
Transfer ID which is communicated to the local system in the FT request confirmation.
SELECT =
Contains selection criteria for outbound requests to be modified. A request is only modified if all the criteria specified are met.
SELECT = *OWN
Modifies all FT requests of the user’s own ID.
SELECT = *PARAMETERS(...)
ENTIFICATION =
Identifies the owner of the FT request.
OWNER-IDENTIFICATION = *OWN
Modifies only outbound requests with the user’s own ID.
OWNER-IDENTIFICATION = *ALL
Modifies outbound requests for all user IDs.
Only the FTAC administrator may use this entry.
OWNER-IDENTIFICATION = <name 1..8>
Specifies a user ID whose requests are to be modified.
Users may only enter their own user ID.
PARTNER =
Modifies outbound requests which are to be executed with a particular partner system.
PARTNER = *ALL
The name of the partner system is not selected as a criterion for the outbound requests to be modified.
PARTNER = <text 1..200 with-low>
Modifies outbound requests which are to be executed with this partner system. You can specify the name from the partner list or the address of the partner system. For more information on address specifications, see section “Specifying partner addresses”.
FILE =
Modifies outbound requests which access this file or library member in the local system as a send or receive file. The file or library member name must be entered exactly as in the file transfer request and as it is output using the NSTATUS command. File names with wildcards are not permitted.
FILE = *ALL
The filename is not selected as a criterion for the outbound requests to be modified.
FILE = <filename 1..59> / <c-string 1..512 with-low>
Modifies outbound requests which access this file (DVS/POSIX) in the local system.
QUEUE-POSITION =
New position of the outbound request that is to be modified in the openFT request queue.
QUEUE-POSITION = *UNCHANGED
The position of the outbound request in this user’s openFT request queue remains unchanged.
QUEUE-POSITION = *FIRST
The outbound request is placed in front of all the other requests of the same priority issued by the user in the openFT request queue.
QUEUE-POSITION = *LAST
The outbound request is placed behind all the other requests of the same priority issued by the user in the openFT request queue.
PRIORITY =
Modifies the priority of the FT request.
PRIORITY = *UNCHANGED
The priority of the FT request remains unchanged.
PRIORITY = *NORMAL
The priority of the FT request is set to the normal value
PRIORITY = *HIGH
The FT request is given a high priority.
PRIORITY = *LOW
The FT request is given a low priority.
Example
|