Function

Parameters

ALL

If you specify ALL without any other parameters except the optional L= parameter, JES2 displays all automatic command entries you are authorized to see.

If you specify ALL with additional operands, JES2 modifies all automatic command entries you are authorized to change.

cccc

The 1 to 4-character identifier of an existing automatic command entry or a new entry generated by JES2. If you do not specify any other parameters except the optional L= parameter, and an automatic command entry with the specified identifier already exists, JES2 displays the entry.

If you specify cccc with additional parameters, and an automatic command entry with this identifier exists, JES2 modifies the entry. If there is no entry with the specified identifier, JES2 generates one.

Note:

1. If you omit this operand and this is not a display-only request, JES2 assigns an identifier for you.
2. Do not specify an identifier that will cause the $TA command to match any existing JES2 command.

   For example, $TA LLOG,I=hh.mm,'$command', requests an automatic command be created with the identifier LLOG. Similarly, if $TA PPL,I=hh.mm,'$command' is specified, it will be misinterpreted as a $TAPPL command.

I=sssss

The time interval, in seconds, at which the specified command(s) are repeated; 10 seconds is the minimum value. Leading zeros may be omitted. The maximum number of seconds is 86,400 (the number of seconds in one day).

If you specify an interval, but do not specify a start time, JES2 assumes an immediate start time, runs the command when entered, and then repeats it continuously at the specified interval.

Refer to Processing Considerations for additional information on how a time or date change affects this parameter.

T=hh.mm

The time of day, in hours and minutes from the last midnight, that the specified command(s) are issued. The maximum value is 168.59 (168 hours, 59 minutes). A leading zero may be omitted from the hour specification.

Refer to Processing Considerations for additional information on how a time or date change affects this parameter.

The following example is set to run at 12:30 a.m., at an interval of 24 hours:

$T A,T=00.30,I=86400,'$VS,''I SMF'''

However, if the command is not submitted until 13:00 (1:00 p.m.), it will be run immediately at 13:00, and then again at 12:30 a.m., and then repeat every 24 hours at 12:30 a.m.

Note:

1. If you specify a time that is earlier than the current time, and you specify an interval, the command is issued immediately, and then repeated at the specified time with the given interval.

   If you specify a time that is earlier than the current time, without specifying an interval, the command is issued immediately and then cancelled.

2. If you specify a time that does not include an hour specification (hh) but only a minute specification (mm), the command is cancelled without being issued.
3. If you modify the system time to an earlier time, the interval is not remembered for more than 168.59 hours (7 days, 59 minutes).

‘command'

The JES2 command that is automatically issued. Multiple commands must be separated by semicolons (;).

Apostrophes within the command text must be doubled, as shown in the following examples. Within a command string, a pair of single quotation marks is interpreted as one single quotation mark.

• If the command you wish to enter is: $VS,'D A', and you want the command to be issued at 20-second intervals starting at 12:05, you would enter: $TA,I=20,T=12.05,'$VS,''D A'''.
• To issue the MVS™ SEND command as an automatic command, you would enter: $TA,I=20,T=12.05,'$VS,''SEND''''message text'''',USER=(userid)'''.

Note:

1. JES2 verifies the validity of and the authority for these commands at command execution time, not when you issue the $T A command.
2. You can route the response messages associated with these commands by specifying the L= operand within the quotation marks.

L=a|name|name-a

The area (a), console name (name), or console name and output area (name-a) of the active MCS console at which the responses to the $T A commands appear. If this operand is omitted, the console of entry is assumed. If the automatic commands are entered through a card reader or an internal reader, console 1 is assumed.

Authority Required

When $T A creates a command element, it requires a console of at least equal authority to reference it with another $T A command.

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS system command group is assigned.

This command can require control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Access level to create an automatic command is always READ. Access level to modify (or cancel) an automatic command depends on whether the requestor created the automatic command. If the requestor created the automatic command, the access level is READ. If not, the access level required is CONTROL.

Processing Considerations

When you code this command, JES2 establishes a starting point (when to begin issuing a command), and an interval (when to repeat a command).

Effects on Automatic Commands When Changing the Date or Time: When a time or date change occurs, the interval (for example, every 2 hours) remains the same, but the time (for example, 1:00 a.m.) when the command will next be issued is recomputed.

Using the example below, several scenarios follow to help you understand the effects of changing the time or date.

$TA, T=1:00,I=7200,'$D LINE 1'

• When You Change the Time Backward or Forward:
  • If, at 1:15 a.m., the clock is set back one hour, making the current time 12:15 a.m., the command will not be issued again at 1:00 a.m., but will be issued at the next interval (two hours beyond 1:00 a.m.), which is 3:00 a.m.
  • If, at 1:15 a.m., the clock is set ahead two hours, making the current time 3:15 a.m., the command will be issued immediately, at 3:15 a.m., and will be issued again at the next interval (two hours beyond 3:15 a.m.), which is 5:15 a.m.
• When You Change the Date Backward or Forward:
  • If the date is changed at 1:15 a.m., from day 200 to day 199, the command will not be issued again at the intervals where the command was already issued. Thus, it won't be issued again until 3:00 a.m. on day 200.
  • If the date is changed at 1:15 a.m., from day 200 to day 201, the command is issued immediately, then scheduled to be issued again at the next interval, which is 3:15 a.m.

Scope

Single member. This command applies to this member only.

Depending on your installation's setup, however, you might want this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP604 message indicates the contents of the command element being created, displayed, modified, or deleted.

The $HASP249 message echoes the command you issued, indicating that the command was received from the automatic command facility.

Assuming the $T A command was issued at console CN3D0, JES2 redirects the response to the $T A command ($HASP604) to console CN3D0. JES2 issues the automatic command ($d u,rdr1) every 30 seconds, preceded by the $HASP249 message. JES2 issues the $HASP603 message in response to the automatic command and redirects this response to console CN3E0.