Future Launches

This section describes the commands on Future launches:
uxadd FLA
,
uxupd FLA
,
uxdlt FLA
,
uxhld FLA
,
uxrls FLA
,
uxshw FLA
and
uxlst FLA
. The default Environment (area / node) can be changed.
The command
uxadd FLA
adds a future launch to the list of future launches. This command displays the created launch number in the standard output. The format is "numlaunch nnnnnnn". Its syntax is as follows:
uxadd FLA [TSK=
task
] [SES=
session
] [VSES=
version
] UPR=
uproc
[VUPR=
version
] MU=
mu
[PRINTER=
printer
] [PRTY=
priority
] [QUEUE=
queue
] USER=
user
[LSTART="(
date
,
hhmm
)"] [LEND="(
date
,
hhmm
)"] [EXLW=(
hhmm
,
hhmm
)] PDATE=
date
[LAUNCHVAR="((
variable
,
value
),(
variable
,
value
)...)"] [FORCE|
NOFORCE
] [BYPASS|
NOBYPASS
] [MUTIME|
ASTIME
] [
VARTSK
|NOVARTSK] [INFO=
information
] [SEV=
severity
]
On OS/400, the command UXADDFLA allows the user to create a launch from the command line. The F4 key allows the user to enter each parameter individually. The F11 key displays the name of each parameter.
The command
uxupd FLA
updates a future launch. Its syntax is as follows:
uxupd FLA [TSK=
task
] [SES=
session
] [VSES=
version
] UPR=
uproc
[VUPR=
version
] MU=
mu
NSEQ=
nnnnnnn
[SINCE=(date,hhmm)] [BEFORE=(date,hhmm)] [STATUS=L|H|W|O|R] [PRINTER=
printer
] [PRTY=
priority
] [QUEUE=
queue
] [USER=
user
] [LSTART="(
date
,
hhmm
)"] [LEND="(
date
,
hhmm
)"] [EXLW=(
hhmm
,
hhmm
)] [NOW] [PDATE=
date
] [LAUNCHVAR="((
variable
,
value
),(
variable
,
value
)...)"] [FORCE|
NOFORCE
] [BYPASS|NOBYPASS] [MUTIME|ASTIME] [INFO=
information
] [SEV=
severity
]
On OS/400, the command UXUPDFLA allows the user to modify a launch from the command line. The F4 key allows the user to enter each parameter individually. The F11 key displays the name of each parameter.
The command
uxdlt FLA
deletes a future launch. Its syntax is as follows:
uxdlt FLA [TSK=
task
] [SES=
session
] [VSES=
version
] UPR=
uproc
[VUPR=
version
] MU=
mu
NSEQ=
nnnnnnn
[SINCE=(date,hhmm)] [BEFORE=(date,hhmm)] [STATUS=L|H|W|O|R]
On OS/400, the command UXDLTFLA allows the user to delete a launch from the command line. The F4 key allows the user to enter each parameter individually. The F11 key displays the name of each parameter.
The command
uxhld FLA
disables a future launch. Its syntax is as follows:
uxhld FLA [TSK=
task
] [SES=
session
] [VSES=
version
] UPR=
uproc
[VUPR=
version
] MU=
mu
NSEQ=
nnnnnnn
[SINCE=(date,hhmm)] [BEFORE=(date,hhmm)] [STATUS=L|H|W|O|R]
The command
uxrls FLA
reactivates a future launch. Its syntax is as follows:
uxrls FLA [TSK=
task
] [SES=
session
] [VSES=
version
] UPR=
uproc
[VUPR=
version
] MU=
mu
NSEQ=
nnnnnnn
[SINCE=(date,hhmm)] [BEFORE=(date,hhmm)] [STATUS=L|H|W|O|R]
The command
uxshw FLA
displays the characteristics of a future launch. Its syntax is as follows:
uxrls FLA [TSK=
task
] [SES=
session
] [VSES=
version
] UPR=
uproc
[VUPR=
version
] MU=
mu
[NSEQ=
nnnnnnn
] [SINCE=(date,hhmm)] [BEFORE=(date,hhmm)] [STATUS=L|H|W|O|R] [OUTPUT=
filename
]
The command
uxlst FLA
lists the future launches. Its syntax is as follows:
uxlst FLA [TSK=
task
] [SES=
session
] [VSES=
version
] [UPR=
uproc
] [VUPR=
version
] [MU=
mu
] [NSEQ=
nnnnnnn
] [SINCE=(date,hhmm)] [BEFORE=(date,hhmm)] [STATUS=L|H|W|O|R] [FULL|
INF
] [ASTIME|MUTIME] [OUTPUT=
filename
]
Description of Items
  • TSK=
    (Optional) Enter a task code or * (wildcard accepted except for
    uxadd
    ). Incompatible with UPR, SES and USER. Format: 64 alphanumeric characters.
  • SES=
    (Optional) Enter a session code or * (wildcard accepted except for
    uxadd
    ). For
    uxdlt FLA
    , if SES = * is not specified, only launches run outside a session are targeted, if SES = * is specified, all launches are targeted. Format: 64 alphanumeric characters.
  • VSES=
    (Optional) Session version. Accepts a specific session version number. By default, all versions of specified sessions are considered (irrelevant for EXP). Format:  3 numeric characters.
  • UPR=
    Enter the Uproc code or * (wildcard accepted except for
    uxadd
    )Format: 64 alphanumeric characters.
  • VUPR=
    (Optional) Uproc version. Accepts a specific Uproc version number. By default, all versions of specified Uprocs are considered (irrelevant for SIM and EXP). Format: 3 numeric characters.
  • MU=
    Management unit code. Enter a Management unit code or * (wildcard accepted except for
    uxadd
    ). Format: 64 alphanumeric characters.
  • NSEQ=
    Enter the launch number targeted by the command or * (to differentiate several launches on the same Uproc - session and management unit). Format: 7 numeric characters.
  • PRINTER=
    (Optional) Printer. Not used under UNIX and Windows.
  • PRTY=
    (Optional) Task’s priority upon entering the batch queue. Format: 3 numeric characters between 001 and 255.
    Default: 100.
  • QUEUE=
    (Optional) Batch queue into which the task will be submitted. Format: 32 alphanumeric characters ("$" accepted under OpenVMS).
    Default: SYS_BATCH (SYS$BATCH on OpenVMS).
  • USER=
    (Optional except
    uxadd
    ) Submission account. User account under which the launch will be run. Format: 64 alphanumeric characters.
  • LSTART=
    (Optional except
    uxadd
    , incompatible with
    NOW
    ) Starting date and time of launch window. Format:
    • On Windows / UNIX / OpenVMS, the format is: (U_FMT_DATE,HHMM) where U_FMT_DATE is the starting date of the launch window with the format indicated by the value of the setting U_FMT_DATE, HHMM is the starting time of the launch window. The number of characters must be respected exactly.
    • On OS/400, the date must be entered in the format used by the system. The time format is HHMMSS.
    Default: immediate launch
  • LEND=
    (Optional except
    uxadd
    , incompatible with
    NOW
    ) Finishing date and time of launch window. Format:
    • On Windows / UNIX / OpenVMS, the format is: (U_FMT_DATE,HHMM) where U_FMT_DATE is the finishing date of the launch window with the format indicated by the value of the setting U_FMT_DATE, HHMM is the finishing time of the launch window. The number of characters must be respected exactly.
    • On OS/400, the date must be entered in the format used by the system. The time format is HHMMSS.
    Default: the length of the launch window is 5 minutes.
  • EXLW=
    (Optional, incompatible with
    NOW
    ) Launch exclusion window. Format:
    • On Windows / UNIX / OpenVMS, the format is: (HHMM,HHMM) where (HHMM is the starting time of the exclusion window, HHMM) is the finishing time of the exclusion. The number of characters must be respected exactly.
    • On OS/400, the date must be entered in the format used by the system. The time format is HHMMSS.
  • NOW
    (Optional, incompatible with
    LSTART
    ,
    LEND
    and
    EXLW
    ) Start time of the launch window: Current time of node where the environment was loaded and a time span of 5 minutes. Can only be used with
    uxupd FLA
    command on Windows / UNIX / OpenVMS.
  • PDATE=
    (Optional except
    uxadd
    ) Processing date qualifying the launch. The actual value depends of the functional period of the Uproc. Format:
    • On Windows / UNIX / OpenVMS, the format is indicated by the value of the setting U_FMT_DATE. The number of characters must be respected exactly.
    • On OS/400, the date must be entered in the format used by the system.
  • LAUNCHVAR=
    (Optional) The complete list of launch variables and their values. The output of the command doesn't display the value of password type variables. Format: (variable,value),(variable),…). The list is enclosed within brackets and quotation marks. Each variable-value pair is bracketed and separated from the following one by a comma (with no space).
    • The variable’s name must be selected from the list of Uproc variables identifying the launch.
    • Where the value of the variable is indicated, this value replaces the value of the task or Uproc variable. If the value is not indicated (there must be no comma present) the default value of the task or Uproc variable is taken into account. If the value contains non-alphanumeric characters (eg. spaces, /…) it must be enclosed within quotation marks. The format of the value must be compatible with the format declared upon creation of the variable in the Uproc.
  • SINCE=
    (Optional) Start of selection window. Determines, based on their scheduled time slot, to observe the launches (all launches are extracted with the time slot has a nonempty intersection with the range of observation). Format:
    • On Windows / UNIX / OpenVMS, the format is: (U_FMT_DATE,HHMM). The format of the date is indicated by the value of the setting U_FMT_DATE, hours and minutes on four characters. The number of characters must be respected exactly.
    • On OS/400, the date must be entered in the format used by the system. The time format is HHMMSS.
  • BEFORE=
    (Optional) End of selection window. Use the filter BEFORE=(99/99/9999,9999) to filter on jobs with no end dates.
    • On Windows / UNIX / OpenVMS, the format is: (U_FMT_DATE,HHMM). The format of the date is indicated by the value of the setting U_FMT_DATE, hours and minutes on four characters. The number of characters must be respected exactly.
    • On OS/400, the date must be entered in the format used by the system. The time format is HHMMSS.
  • STATUS=
    (Optional) Launch status. Enables launches to be selected according to their status, by entering one or more of the following values (separated by a comma):
    • L: Waiting for launch
    • H: Held (disabled)
    • W: Event wait
    • O: Launch window overrun
    • R: Launch refused
    Default: all launches are considered.
  • FORCE | NOFORCE
    (Optional) Forced launch at end of window:
    • FORCE: If at the end of the launch window the task is in an EVENT_WAIT state, it will be submitted for execution regardless.
    • NOFORCE: (default) If at the end of the launch window the task is in an EVENT_WAIT state, it will not be submitted to the execution and will go into Time Overrun.
  • CENTRAL | NOCENTRAL
    (Optional) Obsolete, present for compatibility only.
  • RESTART | NORESTART
    (Optional) Obsolete, present for compatibility only.
  • BYPASS | NOBYPASS
    (Optional) Bypass condition check.
    • BYPASS (on Windows/UNIX/OpenVMS) or Y (on OS/400): indicates that the conditions associated with the Uproc are not examined. The Uproc will therefore be able to run even if its required conditions are not satisfied. In the case of a launch applying to a session, only the first Uproc of the session may be launched without a condition check, the other Uprocs will have their conditions checked as normal.
    • NOBYPASS (on Windows/UNIX/OpenVMS) or N (on OS/400) : (default) indicates that the conditions associated with the Uproc are examined as usual. The Uproc will therefore not be able to run if its required conditions are not satisfied
  • INF | FULL
    (Optional) Display option.
    • INF: (Default) Confines display to the names of the objects. 
    • FULL: Displays all available information on the list of objects.
  • ASTIME | MUTIME
    (Optional) Reference time used by the command.
    • MUTIME: Reference time is that of the Management Unit. The column MU TIME OFFSET is displayed by the
      uxlst
      command.
    • ASTIME (default) or nothing:
      • If the U_TREF node setting is not defined or is "ASTIME", reference time is that of the server.
      • If the U_TREF node setting is "MUTIME", reference time is that of the Management Unit.
    On OS/400, the parameter TYPETIME can take the MUTIME or ASTIME values.
  • VARTSK | NOVARTSK
    (Optional) Variables:
    • VARTSK (or Y on OS/400): (default) The launch is created using the values of variables of the corresponding task (if it exists).
    • NOVARTSK (or N on OS/400): The launch is created using the values of the variables of the Uproc defining the launch.
  • INFO=
    (Optional) Launch Information field.
    • If the INFO argument is present and not set to " " (space character), the launch's Information field will contain the value of the INFO argument.
    • If the INFO argument is missing or set to " " (space character), the contents of the launch's Information field will respect the following rules:
      • By default the launch’s Information field will take the value of the Uproc’s Information field if it has been defined.
      • If the Uproc Information field is not specified and the U_FMT_INFO node setting has been set (Advanced Setting category), the launch Information field will contain the launch’s Uproc and session labels. Refer to the Univiewer User Guide.
  • SEV=
    or
    SEVERITY=
    (on OS/400)
    (Optional) Launch Severity field.
    • If the SEV/SEVERITY argument is present and not set to " " (space character), the launch’s Severity field will contain the value of the SEV argument.
    • If the SEV/SEVERITY argument is missing or set to " " (space character), the launch’s Severity field will take the value of the Uproc Severity field.
  • OUTPUT=
    (Optional) Display option for 
    uxshw
     or 
    uxlst
     commands
    • OUTPUT: Enter the full file name for display storage. 
    • Default: The output is sent to screen.
Examples
  • Creates a launch from the session D_LOAD_BCK, whose Uproc header is D_LOAD_FIL on the HEADQUART management unit in the production area for the admin user account. Launch is planned for 7th May 1999 from 12.55 to 17.00 with the "force launch at end of window" option where the setting U_FMT_DATE has the value YYYYMMDD.
    uxadd FLA EXP SES=D_LOAD_BCK UPR=D_LOAD_FIL VUPR=000 MU=HEADQUART USER=admin LSTART=(19990507.1255) LEND=(19990507.1700) PDATE=19990605 FORCE
  • Updates the launch created above by indicating that the launch will no longer require "force launch at end of window", had this been previously specified. The sequence number NSEQ is supplied by a uxlst fla command.
    uxupd FLA EXP SES=D_LOAD_BCK UPR=D_LOAD_FIL VUPR=000 MU=HEADQUART NOFORCE NSEQ=0000002
  • Suspends the launch created above.
    uxhld FLA EXP SES=D_LOAD_BCK UPR=D_LOAD_FIL VUPR=000 MU=HEADQUART NSEQ=0000002
  • Creates the launch of Uproc IU_LPR on management unit X01 with new values for the two values of the task:
    uxadd fla upr=IU_LPR mu=X01 user=root pdate=00/00/0000 lstart="(08/01/98,1000)" lend="(09/12/98,1000)" launchvar="((VARTXT,TXT__FLA),(VARDATE,2010/01/01))"
  • Modifies the value of the variable VARNUM, the values of VARTXT and VARDATE are conserved:
    uxupd fla upr=IU_LPR mu=X01 nseq="*" launchvar=((VARNUM,693))
  • Holds, releases and deltes the launch on session D_LOAD_BCK, header Uproc D_LOAD_FIL on the management unit HEADQUART:
    uxhld FLA EXP SES=D_LOAD_BCK UPR=D_LOAD_FIL MU=HEADQUART NSEQ=* uxrls FLA EXP SES=D_LOAD_BCK UPR=D_LOAD_FIL MU=HEADQUART NSEQ=* uxdlt FLA UPR=D_LOAD_FIL MU=HEADQUART NSEQ=0000175
  • Lists all launches into the file c:\temp\LstFla.txt:
    uxlst FLA FULL OUTPUT=c:\temp\LstFla.txt