INGSCHED displays a list of all
defined schedules (service periods). It lets you:
Update the time slots (this is referred to as a schedule override).
Display the list of resources that are associated with the schedule.
Delete schedule or resource overrides.
Syntax
schedule options
resource options
date
days
priority
timeslots
Parameters
schedule
Is the name of the schedule to be displayed.
resource
Specifies the resource that the schedule overrides are to be displayed
for. The format is name/type[/system].
REQ
Specifies the request. The request can be:
BASE
Displays the base schedule information.
DEL
Deletes the overrides for the specified date.
DISP
Displays the base schedule, schedule override or resource overrides
starting with the specified date.
REPL
Replaces the schedule or resource override with a new one.
RESOURCES
Displays the resources that use the specified schedule (service
period).
TIMERS
Displays the list of timers that are currently scheduled.
DATE
Specifies the date in yyyymmdd format that the delete or replace
of the override should be done for.
curr_date
The current date.
DAYS
Specifies the number of days for which the overrides should be
displayed or deleted.
PRIORITY
Specifies the priority to be assigned to the override. The first
value is the UP priority and the second value is the DOWN priority.
Valid values are:
HIGH
High priority.
LOW
Low priority.
Both priorities are optional. The default is LOW.
The priority values can be abbreviated.
UP
Specifies the UP start and stop times in the format hhmm-hhmm.
Up to five time slots can be specified separated by a comma. The UP
time slots define the time windows where the resource must or should
be available. A priority of HIGH means that the resource must be available,
while a priority of LOW means that the resource should be available.
DOWN
Specifies the DOWN start and stop times. The format is hhmm-hhmm. Up
to five time slots can be specified separated by a comma. The DOWN
time slots define the time window where the resource must or should
be not available (that is, unavailable). A priority of HIGH
means that the resource must be unavailable, while a priority of LOW
means that the resource should be unavailable. If you specify DOWN,
specifying the UP priority becomes mandatory.
WAIT
Specifies whether or not to wait until the request is complete.
The default is YES.
nnn is the number of seconds to wait
before giving up and reporting that a timeout has occurred. The maximum
time interval is 999 seconds.
The INGSCHED
command can only be used when system operations is initialized.
Service
period overrides cannot be modified immediately after a system time
change where the system clock was set back, for example, in case of
daylight savings. Overrides cannot be modified until the new local
time passes the original pre-adjustment local time.
Security Considerations
The INGSCHED command supports resource level security. If turned on, the following profiles in
class SYSAUTO are checked:
Profile
Authority
Condition
AGT.sysplex.xcfgrp.RES.resname.restype[.ressys]
UPDATE
For resource overrides, when REQ is specified with REPL or DEL.
AGT.sysplex.xcfgrp.RES.svpname.SVP
UPDATE
For schedule overrides, when REQ is specified with REPL or DEL.
The automation agent as well as
the automation manager verify
each time slot being modified. Due to the delay between these verifications,
a time slot of the current day that is still valid when the agent
checks it could already be invalid when the automation manager checks it.
For example, the agent passes an override request to the manager at
10:59:59. The automation manager scheduler
receives the request at 11:00:01 and rejects it because the start
time has already elapsed. This is indicated by return code 8 and reason
code X'10C4' in message INGY1004. If this error occurs, you
can fix it by correcting the time slot in error and reissuing the
override.
Examples
If you enter ingsched a
panel similar to Figure 1 is displayed. Figure 1. INGSCHED Initial Command
Dialog Panel
INGKYSP0 SA z/OS - Command Dialogs Line 1 of 3
Domain ID = IPSNM ---------- INGSCHED ---------- Date = 08/25/03
Operator ID = NETOP1 Time = 13:56:24
Cmd: A Show Details B Show Overrides C Show Resources
Cmd Schedule Description
--- -------- ----------------------------------------
STD_SERV Standard Service Period
TSOPLUS Special service period for TSOPLUS
ONLINE Schedule for CICS applications
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF9=Refresh PF12=Retrieve
The Cmd field allows you to specify command codes. To use
one of the command codes shown, type the appropriate letter next to
the resource name and press Enter. The following command codes are
available:
A
Show Details. Displays the service periods for the selected schedule
without any override.
B
Show Overrides. Displays the overrides for the selected schedule
starting with the current day for the next n days filling one
panel.
C
Show Resources. Displays the list of resources or application
groups that make use of the schedule. This can then be used to modify
the service periods for the resource.
The Schedule field shows the schedule (service period)
defined in the sysplex.
The Description field shows the description specified for
the resource.
Showing Schedule Details
Overrides are shown in white.
The base time slots for a selected schedule are
displayed when specifying command code A in front of the schedule.
The panel in Figure 2 is displayed
(note that INGSCHED REQUEST=BASE shows a similar
panel). Figure 2. INGSCHED
Command Dialog Panel Showing Schedule Details
INGKYSP1 SA z/OS - Command Dialogs Line 1 of 14
Domain ID = IPSFO ---------- INGSCHED ---------- Date = 08/25/03
Operator ID = NETOP1 Sysplex = KEY1PLEX Time = 14:36:07
Schedule. . : SHIFT1 Weekday A.M. (06:00 - 11:59)
Day Pri Strt/Stop Strt/Stop Strt/Stop Strt/Stop Strt/Stop
--- -- --- --------- --------- --------- --------- ---------
MON UP H 0600-1159----
DN H 0000-0559 1200-2400 ---
TUE UP H 0600-1159 ----
DN H 0000-0559 1200-2400 ---
WED UP H 0600-1159 ----
DN H 0000-0559 1200-2400 ---
THU UP H 0600-1159 ----
DN H 0000-0559 1200-2400 ---
FRI UP H 0600-1159 ----
DN H 0000-0559 1200-2400 ---
SAT UP L -----
DN H 0000-2400 ----
SUN UP L -----
DN H 0000-2400 ----
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF9=Refresh PF12=Retrieve
The Schedule field shows the name of the schedule as defined
in the sysplex.
The Day field shows the day of the week.
The Pri field shows the priority associated with the day
of the week. It can have the following values:
H
High priority. The resource must be down or up.
L
Low priority. The resource should be down or up.
The Strt/Stop field shows the begin and end times of the
service window.
Showing Schedule Overrides
To display detailed information for a particular
schedule, specify command code B in front of the schedule. The panel
displayed, as shown in Figure 3,
shows the start and stop times starting from the requested date. The
default starts from the current day. For each day, two rows are displayed:
The first row (UP) shows the time slots when the associated resources
should be up (available).
The second row (DN) shows the time slots when the associated resources
should be down (unavailable).
To modify the start and stop times for the various days,
overtype them. Start and stop times that have been overwritten are
shown in yellow. The overrides for a particular day can be removed
with command code D, except for time slots that are affected by the
current time. The time slots will then be restored to the original
values.
INGKYSP2 SA z/OS - Command Dialogs
Domain ID = IPSFO ---------- INGSCHED ---------- Date = 08/25/03
Operator ID = AFRANCK Sysplex = KEY1PLEX Time = 14:53:15
Schedule. . : SHIFT1 Weekday A.M. (06:00 - 11:59)
Starting date => 08 / 25 / 2003 (mm/dd/yyyy)
C Date Pri Strt/Stop Strt/Stop Strt/Stop Strt/Stop Strt/Stop
- ------------ -- --- --------- --------- --------- --------- ---------
08/25/03 Mon UP H 06001159----
DN H 0000055912002400---
08/26/03 Tue UP H 06001159----
DN H 0000055912002400---
08/27/03 Wed UP H 06001159----
DN H 0000055912002400---
08/28/03 Thu UP H 06001159----
DN H 0000055912002400---
08/29/03 Fri UP H 06001159----
DN H 0000055912002400---
08/30/03 Sat UP L -----
DN H 00002400----
08/31/03 Sun UP L -----
DN H 00002400----
09/01/03 Mon UP H 06001159----
DN H 0000055912002400---
09/02/03 Tue UP H 06001159----
DN H 0000055912002400---
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF7=Backward PF8=Forward PF9=Refresh PF12=Retrieve
To delete individual overrides, blank out the appropriate time
slot.
Showing Resources Related to
a Schedule
A list of resources that
use the selected schedule is displayed when specifying command code
C in front of the schedule. A panel similar to Figure 4 is displayed. Figure 4. INGSCHED Command Dialog
Panel Showing Resources Related to a Schedule
INGKYSP3 SA z/OS - Command Dialogs Line 1 of 6
Domain ID = IPSFO ---------- INGSCHED ---------- Date = 08/25/03
Operator ID = NETOP1 Sysplex = KEY1PLEX Time = 14:57:29
Schedule. . : SHIFT1 Weekday A.M. (06:00 - 11:59)
Cmd: S Show Overrides
Cmd Resource Type System Description
--- -------- ---- -------- ----------------------------------------
MSCSUBSYS APL KEY3 test application
MSCSUBSYS APL KEY4 test application
STDT001AA00 APL KEY1 A. M. shift (6:00 - 11:59)
STDT001AA00 APL KEY2 A. M. shift (6:00 - 11:59)
STDT001AA00 APL KEY3 A. M. shift (6:00 - 11:59)
STDT001AA00 APL KEY4 A. M. shift (6:00 - 11:59)
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF9=Refresh PF12=Retrieve
The Cmd field allows you to display specific information
for each system. The following command code is available:
S
Shows overrides. Changes service periods for the resource group.
The Resource field shows the name of the resource that
uses the specified schedule.
The Type field shows the type of the resource.
The System field shows the name of the system that the
resource resides on.
The Description field shows the description specified for
the resource.
A panel similar to Figure 5 shows schedule overrides for
the selected resource. Figure 5. INGSCHED
Command Dialog Panel Showing Resource Overrides
INGKYSP2 SA z/OS - Command Dialogs
Domain ID = IPUFA ---------- INGSCHED ---------- Date = 08/26/03
Operator ID = NETOP1 Sysplex = AOCPLEX Time = 14:56:08
Resource . . . : STDT005AA00/APL/AOCA Schedule . . : SHIFT5
Starting date => 07 / 04 / 2000 (mm/dd/yyyy)
C Date Pri Strt/Stop Strt/Stop Strt/Stop Strt/Stop Strt/Stop
- ------------ -- --- --------- --------- --------- --------- ---------
08/26/03 Tue UP L
DN H 00001900
08/27/03 Wed UP L 16001800
DN H 18001900
08/28/03 Thu UP L
DN H 00001900
08/29/03 Fri UP L
DN H 00001900
08/30/03 Sat UP L
DN H 00001900
08/31/03 Sun UP L
DN H 00001900
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF7=Backward PF8=Forward PF9=Refresh PF12=Retrieve
The panel shows the service windows currently defined for the
resource. The service windows are determined as follows:
Base service periods from the associated schedule, if any are
defined.
Override service periods from the associated schedule, if any
are defined.
Override service periods associated with the resource.
The Day field shows the day of the week.
The Pri field shows the priority associated with the day
of the week. It can have the following values:
H
High priority.
L
Low priority.
The Strt/Stop fields show the beginning and end times of
the service window. For each day, two rows are displayed.
The first row (UP) shows the time slots when the associated resources
must be up (available).
The second row (DN) shows the time slots where the associated
resources must be down (unavailable).
Time slots that are overrides for the resource are shown in pink.
Time slots defined for the base schedule are shown in green, while
its overrides are shown in yellow. Time slots that are already passed
cannot be deleted or overridden. To set an override, type over the
appropriate time field.
