|
Function To perform the following functions: - Display the automatic commands currently in effect.
- Specify a new command or series of commands for automatic processing.
- Modify an existing automatic command entry.
Syntax
>>-$T--A-------------------------------------------------------->
>--+-,ALL----,I=--sssss--+-------------+--,'command--(--;command--)--…'---+-->
| '-,T=--hhh.mm-' |
+-,ALL----,T=--hhh.mm--+------------+--,'command--(--;command--)--…'---+
| '-,I=--sssss-' |
+-cccc----,I=--sssss--+-------------+--,'command--(--;command--)--…'---+
| '-,T=--hhh.mm-' |
'-cccc----,T=--hhh.mm--+------------+--,'command--(--;command--)--…'---'
'-,I=--sssss-'
>--,L=--+-a------+---------------------------------------------><
+-name---+
'-name-a-'
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: - If you omit this operand and this is not a display-only request,
JES2 assigns an identifier for you.
- 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: - 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.
- 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.
- 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: - JES2 verifies the validity of and the authority for these commands
at command execution time, not when you issue the $T A command.
- 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.
By issuing the command: $TA, T=1:00,I=7200,'$D LINE 1'
the
interval is set for an automatic command to be issued every two hours.
It is first issued at 1:00 a.m. The next issuance would be at 3:00
a.m.
- 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.
Examples 1 $t a,i=90,'$du,prt6'
$HASP604 ID 2 T=**.** I= 90 L=CN3D0 $DU,PRT6
$HASP249 COMMAND RECEIVED FROM AUTO COMMAND ID=2
$DU,PRT6
$HASP603 PRT6
$HASP603 PRT6 UNIT=000F,STATUS=DRAINED,BURST=NO,CKPTLINE=0,
$HASP603 CKPTMODE=PAGE,CKPTPAGE=100,CKPTSEC=0,
$HASP603 CREATOR=,DEVFCB=,FCB=STD3,FORMS=(STD,,,,,,,),
$HASP603 FSS=HFAM,JOBNAME=,LASTFORM=STD,LIMIT=(0,*),
$HASP603 COPYMARK=DATASET,MARK=NO,MODE=FSS,
$HASP603 NEWPAGE=DEFAULT,NPRO=300,PAUSE=NO,PLIM=(0,*),
$HASP603 PRESELCT=YES,PRMODE=(LINE),QUEUE=HFAM,
$HASP603 RANGE=(J1,32767),ROUTECDE=(LOCAL),SEP=YES,
$HASP603 SEPCHARS=DEFAULT,SEPDS=NO,SETUP=HALT,SPACE=,
$HASP603 TRACE=NO,TRANS=DEFAULT,TRKCELL=NO,UCS=GT10,
$HASP603 UCSVERFY=NO,VOLUME=(,,,),WRITER=,
$HASP603 WS=(W,Q,R,PRM,LIM/F,UCS,FCB)
JES2 issues the $HASP604 message in response to the $T A
command. JES2 issues the automatic command ($D U,PRT6) every 90 seconds, preceded by the $HASP249 message. JES2 issues the
$HASP603 message in response to the automatic command. 2 $t a,all
$HASP604 ID 2 T=17.29 I= 90 L=CN3D8 $DPRINTDEF
$HASP604 ID 1 T=17.30 I= 90 L=CN3E0 $DUPRT6
JES2 displays all the automatic command entries you are
authorized to see. 3 $t a,i=90,'$du,prt6,1=cn3d8-a',l=b
At console CN3D0 in out of line area B (assuming
the example 3 command is entered there and area B is defined): $HASP636 11.34.44 $TA,I=90,'$DU,PR FRAME LAST F E SYS=SY1
ID 6 T=***.** I= 90 L=CN3D0 $DU,PRT6,L=CN3D8-A
At console CN3D8 in the inline area: $HASP249 COMMAND RECEIVED FROM AUTO COMMAND ID=6
$DU,PRT6
At console CN3D8 in out of line area A (assuming
area A is defined and is large enough so that all output can be displayed):
$HASP636 17.11.04 $DU,PRT6 FRAME 1 F E SYS=SY1
PRT6 UNIT=000F,STATUS=DRAINED,BURST=NO,CKPTLINE=0,
CKPTMODE=PAGE,CKPTPAGE=100,CKPTSEC=0,
CREATOR=,DEVFCB=,DEVFLASH=****,FCB=STD3,
FORMS=(STD,,,,,,,),FSS=HFAM,HONORTRC=YES,
JOBNAME=,LASTFORM=STD,LIMIT=(0,*),
COPYMARK=DATASET,MARK=NO,MODE=FSS,
NEWPAGE=DEFAULT,NPRO=300,PAUSE=NO,PLIM=(0,*),
PRESELCT=YES,PRMODE=(LINE),QUEUE=HFAM,
RANGE=(J1,999999),ROUTECDE=(LOCAL),SEP=YES,
SEPCHARS=DEFAULT,SEPDS=NO,SETUP=HALT,SPACE=,
TRACE=NO,TRANS=DEFAULT,TRKCELL=NO,UCS=GT10,
UCSVERFY=NO,VOLUME=(,,,),WRITER=,
WS=(W,Q,R,PRM,LIM/F,UCS,FCB),FSAROLTR=YES,
NOTIFY=
Assuming the $T A command was issued at
console CN3D0, JES2 redirects the $HASP636 message in response to
the $T A command to out-of-line area B at console CN3D0. JES2 issues
the automatic command ($D U,PRT6) every 90 seconds, preceded by the
$HASP249 message in the inline area of console CN3D8. JES2 issues
the $HASP636 message in response to the automatic command, then redirects
this response to out-of-line area A of console CN3D8. Neither
$HASP604 nor $HASP603 message ID appears when the response is directed
to an out-of-line area. 4 $t a,i=30,'$du,rdr1,l=CN3E0'
At console CN3D0 in the inline area (assuming
the example 4 command is entered there): $HASP604 ID 5 T=***.** I= 30 L=CN3D0 $DU,RDR1,L=CN3E0
At console CN3E0 in the inline area: $HASP249 COMMAND RECEIVED FROM AUTO COMMAND ID=5
$DU,RDR1
$HASP603 RDR1
$HASP603 RDR1 UNIT=000C,STATUS=DRAINED,AUTH=(DEVICE=NO,
$HASP603 JOB=NO,SYSTEM=NO),CLASS=A,HOLD=NO,MSGCLASS=A,
$HASP603 PRIOINC=0,PRIOLIM=15,PRTDEST=LOCAL,
$HASP603 PUNDEST=LOCAL,SYSAFF=(ANY),TRACE=NO,
$HASP603 XEQDEST=LOCAL
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.
Note: Neither $HASP604 nor $HASP603 message ID appears when
the response is directed to an out-of-line area.
|