Note on usage
Function: Modify request queue
User group: FT user and FT administrator
Alias name: FTMODREQ
Functional description
You use the MODIFY-FILE-TRANSFER 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.
MODIFY-FILE-TRANSFER 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
MODIFY-FILE-TRANSFER / 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..54> / <c-string 1..512 with-low> / *LIBRARY-ELEMENT(...) *LIBRARY-ELEMENT(...) LIBRARY = *ALL / <filename 1..54> ,ELEMENT = *ALL / <filename 1..64 without-gen-vers>(...) / <composed-name 1..64 with-under>(...) <filename>(...) / composed-name 1..64>(...) VERSION = *ALL / <text 1..24> ,TYPE = *ALL / <name 1..8> ,MONJV = *NONE / <filename 1..54> ,JV-PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647> / *SECRET ,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(...)
OWNER-IDENTIFICATION =
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 SHOW-FILE-TRANSFER 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..54> / <c-string 1..512 with-low>
Modifies outbound requests which access this file (DVS/POSIX) in the local system.
FILE = *LIBRARY-ELEMENT(...)
Modifies outbound requests which access library members in the local system.
LIBRARY =
Selects the library.
LIBRARY = *ALL
The library name is not selected as a criterion for the outbound requests to be modified
LIBRARY = <filename 1..54>
Outbound requests are to be modified which access this library.
ELEMENT =
Library member.
ELEMENT = *ALL
The name of the library member is not selected as a criterion for the outbound requests to be modified.
ELEMENT = <filename 1..64 without-gen-vers>(...) /
<composed-name 1..64 with-under>(...)
Name of the library member.
VERSION =
Version of the member.
VERSION = *ALL
The library member version is not selected as a criterion for the outbound requests to be modified.
VERSION = <text 1..24>
Only outbound requests which access this version of the library member are to be modified.
TYPE =
Type of library member.
TYPE = *ALL
The member type is not selected as a criterion for the outbound requests to be modified.
TYPE = <name 1..8>
Only outbound requests which access library members of this type are to be modified.
MONJV =
Selects any outbound request which is monitored by this job variable.
MONJV = *NONE
No job variable is used as a selection criterion for outbound requests to be changed.
MONJV = <filename 1..54>
The outbound request monitored by this job variable is to be modified.
JV-PASSWORD =
Password which is needed to access the job variable.
If you have already entered the password using the BS2000 command ADD-PASSWORD, you do not need to enter JV-PASSWORD.
JV-PASSWORD = *NONE
The job variable is not password-protected or it does not need to be specified.
JV-PASSWORD = <c-string 1..4> / <x-string 1..8> /
<integer -2147483648..2147483647>
This password is required for the job variable.
JV-PASSWORD = *SECRET
The system prompts you to enter the password. The entry does not appear on the screen.
QUEUE-POSITION =
New position of the outbound request that is to be modified in the openFT request queue. The position of an FTAM request can only be changed relative to the requests that affect the same FTAM partner.
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.
Command return codes
(SC2) | SC1 | Maincode | Meaning/Guaranteed messages |
0 | 0 | CMD0001 | There are no requests that meet the specified selection criteria. |
32 | 32 | CMD0221 | Request rejected. Internal error. Job variable not accessible. |
33 | 32 | CMD0221 | Request rejected. Internal error. |
36 | 32 | CMD0221 | Request rejected. Request data inconsistent. |
82 | 32 | CMD0221 | Internal error. Job variable not accessible. |
83 | 32 | CMD0221 | Internal error. |
36 | 64 | FTR1036 | User not authorized for other user IDs. |
47 | 64 | FTR1047 | Request with the specified transfer ID could not be found. |
226 | 64 | FTR2226 | Job variable contents inconsistent. |
227 | 64 | FTR2227 | Job variable not in use by openFT. |
228 | 64 | FTR2228 | Job variable not found. |
SC1/2 = Subcode 1/2 in decimal notation For additional information, see section “Command return codes”. | |||
Example
|