Operation and Control › Using the MODIFY Commands › ALTER Command › Operands

Operands

The following operands are used with the ALTER command:

DATE

Alters the starting date of the file transfer with request number nnnnnn. The new starting date can be coded in one of two formats:

• yyyymmdd

  where:

  • yyyy is a four‑digit designation for a year (for example, 2005)
  • mm is a two‑digit designation for one of the twelve months of the year as shown in the following chart:

        1 = January          2 = February        3 = March
        4 = April            5 = May             6 = June
        7 = July             8 = August          9 = September
       10 = October         11 = November       12 = December
    

  • dd is a two‑digit number in the range 01 to 31, designating a day of the month

Example

To change the start date for request 1084 to June 1, 2009, specify the following:

/F XCOM,ALTER,1084,DATE,20090601

• yyddd (Julian date)

  where:

  • yy is a two‑digit designation for a year (for example, 02)
  • ddd is a three‑digit number in the range 001 to 366, designating a day of the year

Example

To change the start date for request 1084 to February 1, 2009 (that is, the 32nd day of 2009), specify the following:

/F XCOM,ALTER,1084,DATE,09032

If no date is coded, the default value of DATE is assumed as the new starting date.

Default: Current date

EPRTY

Alters the execution priority (nnn) of the file transfer with request number nnnnnn. The new execution priority can be coded in the operand nnn following the keyword EPRTY. If the operand nnn is not coded, the default value of EPRTY is assumed as the new execution priority.

If several file transfers are active at the same time, the processing priority is given to that transfer that has the highest execution priority number.

Default: 16

hhmm

Specifies the hour (hh) and minute (mm) when the transfer with request number nnnnnn is to start (on the originally scheduled day).

nnn

Specifies a number in the range 1 to 255 to indicate either the execution or scheduling priority of the given file transfer.

Following the keyword EPRTY, this number indicates the new execution priority of the file transfer with request number nnnnnn. The lowest execution priority is 1.

Following the keyword SPRTY, this number indicates the new scheduling priority of the file transfer with request number nnnnnn. The lowest scheduling priority is 1.

nnnnnn

Specifies the transfer request number.

SPRTY

Alters the scheduling priority of the file transfer with request number nnnnnn. The new scheduling priority can be coded in the operand nnn following the keyword SPRTY. If the operand nnn is not coded, the default value of SPRTY is assumed as the new scheduling priority.

If several transfers are scheduled to occur at the same time, they are initiated in order of their priority numbers.

Default: 16

TIME

Alters the starting time (hhmm) of the file transfer with request number nnnnnn. The new starting time can be coded in the operand hhmm following the keyword TIME. If the operand hhmm is not coded, the default value of TIME is assumed as the new starting time (on the originally scheduled date).

Default: 0000 (that is, midnight)

yyddd

Specifies a date according to the Julian calendar. For example, 09105 refers to the 105th day of year 2009.