Exceptions

This section describes the commands on exceptions. The default Environment (area _ node) can be changed.

The command uxadd OEX adds an exception to the lists of exceptions. Its syntax is as follows:

uxadd OEX TYPE=SKIP|BYPASS|HOLD|JUMP MU=mu|MUT=mut UPR=uproc [VUPR=version] [TSK=task] [TASK_MU=mu] [SES=session] [VSES=version] [NUMLANC=numlanc] [NUMSESS=numsess] [NUMORDART_SE=number] [EVT|NOEVT] [LABEL=label] [PDATE=date] [ESTART=(date,hhmm)|NOW] [EEND=(date,hhmm)|NOW+1] [MAXCOUNT=nnnnnn]

The command uxupd OEX updates an exception. Its syntax is as follows:

uxupd OEX [TYPE=SKIP|BYPASS|HOLD|JUMP] MU=mu|MUT=mut UPR=uproc [VUPR=version] [TSK=task] [SES=session] [VSES=version] [NUMLANC=numlanc] [NUMSESS=numsess] [NUMORDART_SE=number] [EVT|NOEVT] [LABEL=label] [PDATE=date] [ESTART=(date,hhmm)] [EEND=(date,hhmm)] [LSTART=(date,hhmm)] [LEND=(date,hhmm)][MAXCOUNT=nnnnnn]

The command uxdlt OEX deletes an exception. Its syntax is as follows:

uxdlt OEX TYPE=SKIP|BYPASS|HOLD|JUMP MU=mu|MUT=mut UPR=uproc [VUPR=version] [TSK=task] [SES=session] [VSES=version] [NUMLANC=numlanc] [NUMSESS=numsess] [NUMORDART_SE=number] [PDATE=date] [ESTART=(date,hhmm)] [EEND=(date,hhmm)]

The command uxlst OEX list the exceptions. Its syntax is as follows:

uxlst OEX [TYPE=SKIP|BYPASS|HOLD|JUMP] [MU=mu|MUT=mut] [UPR=uproc] [VUPR=version] [TSK=task] [SES=session] [VSES=version] [NUMLANC=numlanc] [NUMSESS=numsess] [NUMORDART_SE=number] [PDATE=date] [ESTART=(date,hhmm)] [EEND=(date,hhmm)] [FULL|INF] [OUTPUT=filename]

Description of Items

• TYPE=

  (Compulsory for uxadd) Exception type. Enter one of the four keywords below:

  • SKIP: launch with examination of conditions but without executing the script
  • BYPASS: launch without conditions check (without examination of conditions)
  • HOLD: launch suspended
  • JUMP: no launch: no examination of conditions, no script execution

• MU=

  (Compulsory for uxadd if MUT is absent) Enter a Management unit code or * (wildcard value accepted except for uxadd), incompatible with MUT.
  Format: 64 alphanumeric characters.

• MUT=

  (Compulsory for uxadd if MU is absent) Enter Management unit type code or * (wildcard value accepted except for uxadd), incompatible with MU.
  Format: 1 alphanumeric character.

• UPR=

  (Compulsory for uxadd) Enter a Uproc code or * (wildcard value accepted except for uxadd).
  Format: 64 alphanumeric characters.

• VUPR=

  (Optional) Uproc version. Allows entry of a particular Uproc version (useless with SIM and EXP).
  Format: 3 alphanumeric characters.

• TSK=

  (Optional) Main task code: an exception can not be created on a specific task.
  Format: 64 alphanumeric characters.

• TASK_MU=

  (Optional) The task’s Management Unit code. The task's Management Unit may differ from the exception's Management Unit in the case of a Session if a specific Management Unit or HDP was defined, as with an optional or provoked task. If a task code is not provided, this field is not considered. If a Task code is provided and this field is left empty, then the exception's Management Unit code is automatically assigned to the task's Management Unit code.
  Format: 64 alphanumeric characters.

• SES=

  (Compulsory if NUMSESS is specified) Session code.
  Format: 64 alphanumeric characters.

• VSES=

  (Optional) Session version (useless with EXP).
  Format: 3 alphanumeric characters.

• NUMSESS=

  (Optional) Session execution number. This number is used to distinguish two launches on the same session on the same Management unit for the same processing date.
  Format: 7 alphanumeric characters.

• NUMLANC=

  (Optional) Launch number. Incompatible with MUT. This number is used to distinguish two launches on the same task for the same processing date. If NUMLANC is filled with a value >0, VUPR (if different from default value), SES (if necessary) and VSES (idem) must also be provided.
  Format: 7 alphanumeric characters.

• NUMORDART_SE=

  (Compulsory if NUMSESS is specified and for JUMP exceptions) Uproc number in the session to differentiate two Uprocs in the same session.
  Format: 7 alphanumeric characters.

• EVT | NOEVT

  (Optional) For JUMP exceptions, if the execution did not occur:

  • EVT: the event is created.
  • NOEVT: the event is not created.

  Default: NOEVT

• LABEL=

  (Optional) Exception description.
  Format: 64 alphanumeric characters.

• PDATE=

  (Optional) Processing date associated with the launch. The number of characters must be respected exactly. The value depends on the functional period of the Uproc.
  Format: specified by the U_FMT_DATE variable value. The number of characters must be respected exactly.

  If PDATE is entered in zeros (i.e. 00/00/0000,0000) for uxadd and uxupd oex commands, the exception has no specified processing date and will only be applied on launches without processing date.

• ESTART=

  (Optional) Date and hour of the exception window start (for uxadd) or filter on this window for the other commands.
  Format: (U_FMT_DATE,hhmm).

• EEND=

  (Optional) Date and hour of the end of the exception window (for uxadd) or filter on this window for the other commands.
  Format: (U_FMT_DATE,hhmm).
  

  If ESTART and EEND are entered in zeros (i.e. 00/00/0000,0000) then the exception has no specified time range.

• LSTART=

  (Optional) New date and hour of the exception window start.
  Format: (U_FMT_DATE,hhmm).

• LEND=

  (Optional) New date and hour of the exception window end.
  Format: (U_FMT_DATE,hhmm).

• MAXCOUNT=

  (Optional) Launch number on which the exemption is applied. Beyond, the exception will not be applied even if the time frame is valid nor even if the processing date is valid.

• INF | FULL

  (Optional) Display option.

  • INF: Confines display to the names of the objects.
  • FULL: Displays all available information on the list of objects.

  Default: INF

• OUTPUT=

  (Optional) Output file for display storage of uxlst command. If the item is not supplied, the output is sent to screen.

Examples

• Create a "launch without condition check" type exception for the  Uproc D_LOAD_FIL launch for the SIEGE Management unit for a date in the YYYYMMDD format:

  uxadd OEX TYPE=BYPASS UPR=D_LOAD_FIL MU=SIEGE PDATE=20110714

• Update this exception to change it to JUMP:

  uxupd OEX TYPE=JUMP UPR=D_LOAD_FIL MU=SIEGE

• Delete the exception previously created and updated:

  uxdlt OEX TYPE=JUMP UPR=D_LOAD_FIL MU=SIEGE PDATE=20110714

• List all exceptions to the c:\temp\LstOex.txt file:

  uxlst oex full output=c:\temp\LstOex.txt