Resources

This section describes the settings commands on resources. Also refer to section "Resources" for operation commands.

The command uxadd RES adds a resource to the resources list. Its syntax is as follows:

uxadd RES RES=resource [LABEL=label] NATURE=FIL|LOG|SAE|SAJ|SCR|SYS|SPM|DSK|PRC|QUE|SYS [FNAME=filename] [DIR=directory] [LOCK|UNLOCK] [CLEAR|NOCLEAR] [REGEXP|NOREGEXP] [QT1=quota] [QT2=quota] [FREQ=seconds] [PARAM=parameters] [VALIDITY=seconds]

The command uxupd RES modifies the characteristics of a resource. Its syntax is as follows:

uxupd RES RES=resource [LABEL=label] [NATURE=FIL|LOG|SAE|SAJ|SCR|SYS|SPM|DSK|PRC|QUE|SYS] [FNAME=filename] [DIR=directory] [LOCK|UNLOCK] [CLEAR|NOCLEAR] [REGEXP|NOREGEXP] [QT1=quota] [QT2=quota] [FREQ=seconds] [PARAM=parameters] [VALIDITY=seconds]

The command uxshw RES displays the definition and allocation of a resource. Its syntax is as follows:

uxshw RES RES=resource [ESP=X|S|I|A|*|" "] [MU=mu] [TSOC=company] [PDATE=yyyymmdd] [INF|RSV|FULL] [OUTPUT=filename]

The command uxdlt RES deletes a resource. Its syntax is as follows:

uxdlt RES RES=resource

The command uxlst RES lists the resources. Its syntax is as follows:

uxlst RES [RES=resource] [INF|FULL] [OUTPUT=filename]

The command uxext RES extracts the complete definition of a resource. Its syntax is as follows:

uxext RES RES=resource [REPL] [NOVERIF] OUTPUT=filename

The command uxins RES inserts the complete definition of a resource in the corresponding Dollar Universe files for the same Dollar Universe version. Its syntax is as follows:

uxins RES RES=resource [REPL] INPUT=filename

Description of Items

• RES=

  Resource reference. Enter the reference of the resource or * (wildcard accepted except for uxadd)
  Format: 64 alphanumeric characters.

• LABEL=

  (Optional) Label describing the resource.
  Format: 64 alphanumeric characters.

• NATURE=
  Defines the nature of the resource.

  The table below summarizes the types of resources available depending on the DUAS version and operating system:

  	Code	DUAS version	Windows	UNIX/Linux	OpenVMS	OS/400
  File	FIL	V5 and V6	yes	yes	yes	yes
  Logical	LOG	V5 and V6	yes	yes	yes	yes
  SAP Event*	SAE	V5 and V6	yes	yes	no	no
  SAP Job*	SAJ	V5 and V6	yes	yes	no	no
  JMS*	JMS	V5 and V6	yes	yes	no	no
  REST*	REST	V6	yes	yes	no	no
  SOAP*	SOAP	V6	yes	yes	no	no
  Script	SCR	V6	yes	yes	no	no
  System	SYS	V6	yes	yes	no	no
  SP Monitor	SPM	V6	yes	yes	no	no

  * These types of resources are usable according to the Dollar Universe Managers installed. These types of resources are described in the corresponding documentations (SAP: Manager for SAP Solutions, JMS: Manager for Java, REST and SOAP : Manager for Web Services).

• FNAME=

  (Optional) File or resource name. Enter the file name associated with a resource of the nature FIL or SCR or, if using a logical resource, enter the name of a virtual file used for checking the resource.
  Format: 60 characters max.
  This name may contain the variables !UG! or !MU!, !DTRAIT! or !PDATE!, !ESP! or !AREA! and !SOC! or !COMP! which will be translated during the associated Uproc's condition check (depending on the execution context). It can also contain a wildcard "*" .

  If the nature of the resource is FIL:

  • The variables !APP!, !SESS! and !UPR! can also be used.
  • The name may contain any variables if they are entered between exclamation marks, for example !VARIABLE!.
  • Used with the keyword REGEXP, this field corresponds to a regular expression (Tcl/Tk library version 8.1 with option "ERE" meaning that only the syntax of 8.0 is supported; follow this URL https://tcl.tk/doc/howto/regexp81.html#part1_2 for more details).
    The following characters are supported for regular expressions:
    • A wildcard: any character “.”
    • Repeat: zero or more occurrences of previous character or class “*”
    • Line positions: beginning of line “^”
    • Line position: end of line “$”
    • Character class: any one character in set. Example: [clas]
    • Inverse class: any one character not in set. Example: [^clas]
    • Range: any characters within the specified range. Example: [0-9]
    • Escape: literal use of metacharacter “x”. Example: \x
    • Word position: beginning of word. Example: \<xyz
    • Word position: end of word. Example: xyz\>

• REGEXP | NOREGEXP

  (Optional) Regular expression flag

  • REGEXP: Indicates that a regular expression is used to parse for a file or files.
  • NOREGEXP: Indicates that no regular expression is used to parse for a file or files.

  Default: NOREGEXP

• FREQ=

  (Optional) Supervisor verification cycle. The format for the verification period is 30 to 86400 seconds.

  Default: 30 seconds.

• PARAM=

  (Optional) For a Script-type resource only. Corresponds to the list of parameters to be passed to the script during its execution.

  • Parameters must be separated by spaces.
  • They can contain variable elements of Dollar Universe (! UG!,! DTRAIT!, "SOC" and "ESP").
  • They may contain variables known to the execution environment of Uproc.
  • The maximum length is 60 characters. Once the values are defined, they cannot be more than 1024 characters.

• VALIDITY=

  (Optional) For a Script-type resource only. The validation frequency is the period during which the return code of the script will be considered valid for checking the condition of the resource. The time validity value must be superior to the supervisor verification cycle (FREQ).

• DIR=

  (Optional) For a resource of the FIL and SCR nature only, enter the file access path. This name may contain the variables !UG!, !DTRAIT!, !ESP! and !SOC! that will be translated during the associated Uproc's condition check (depending on the execution context).
  Format: 256 characters max.

• LOCK | UNLOCK

  (Optional, incompatible with QT1 or QT2) Allocate the resource. Indicates that the associated Uproc will be able to assign itself all or part of the resource quotas.

  • LOCK : The associated Uproc will assign itself the totality of the resource quotas during execution, preventing any other Uproc conditioned by the same resource from running simultaneously.
  • UNLOCK: several Uprocs can share the resource.

  Default: UNLOCK

• QT1=, QT2=

  (Optional, incompatible with LOCK) Allocation quotas (levels 1 and 2 respectively). In the uxadd or uxupd commands, enable the definition of maximum quotas which may be assigned during the execution of a uxhld command or during the execution of a Uproc conditioned by this resource.
  Format: from 0 to 9999.

• CLEAR | NOCLEAR

  (Optional) Resource de-allocation.

  • CLEAR: Releases the selected resource. In the uxadd or uxupd commands, resources will only effectively be released upon completion of the conditioned Uproc. The conditioned Uproc will release only those quotas which it previously held.
  • NOCLEAR: Indicates that the resource quota held will not be released when the conditioned Uproc completes: The uxrls command must be run to de-allocate the resource.

  Default: CLEAR

• ESP=

  (Optional) Filters the resources displayed by name according to the value of the variable !ESP! or !AREA! contained in their name: X for production area, S for simulation area, I for integration area, A for application area, * for all areas, " " for no area.

• MU=

  (Optional) Filters the resources displayed by name according to the value of the variable !UG! or !MU! contained in their name: Enter a management unit code or * or "" for no MU name.

• TSOC=

  (Optional) Filters the resources displayed by name according to the value of the variable !SOC! or !COMP! contained in their name: Enter a company code or * or "" for no company name.

• PDATE=

  (Optional) Filters the resources displayed by name according to the value of the variable !DTRAIT! or !PDATE! contained in their name: Enter a processing date using the YYYYMMDD format or * or "" for no processing date.

• 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: FULL

• INF | FULL | RSV

  (Optional) Display option for uxshw RES command.

  • INF: Confine display to the names of the objects.
  • FULL: Display Resource allocation. Displays all information concerning a resource allocation: the source Uproc, quotas allocated by a Uproc, quotas allocated by commands, available quotas.
  • RSV: Display the resource reservations.

  Default: INF

• REPL

  (Optional) Replacement flag. Indicates whether the extracted (or inserted) records delete and replace the records that already exist in the destination file.

  Default: Extraction (or insertion) is refused for each record that already exists (indicated by a message for each occurrence).

• NOVERIF

  (Optional) only to be used with the uxext command. Force the command to skip the checking of the output data file before insertion of new records. This enhances performance and can only be used for the creation of a new output data file.

• OUTPUT=

  • Output file for the uxext command.
  • (Optional) Output file for display storage of uxshw or uxlst commands.

  Default: The output is sent to screen.

• INPUT=

  Input file for the uxins command.

Examples

• Create two resources:

  • The resource D_FIL_PAY which indicates the arrival of a file. This resource is exclusive and release is automatic when the conditioned Uproc completes.

    uxadd RES RES=D_FIL_PAY LABEL=\"Waiting for pay file\" nature=FIL FNAME=pay DIR=c:\temp\ LOCK CLEAR

  • The resource D_BASE concerns protection of access to a base. This is a logical resource specific to the area and to the Management unit executing the conditioned Uproc. It can be shared and must be released by a uxrls command in a Uproc script.

    uxadd RES RES=D_BASE LABEL=\"Base protection\" NATURE=LOG FNAME=!UG!!ESP! DIR=c:\temp QT1=10 QT2=10 NOCLEAR

• Update file name to c:\temp\pay_!DTRAIT!:

  uxupd RES RES=D_FIL_PAY FNAME=pay_!DTRAIT!

• Create the resource D_FILE which uses a regular expression to parse for files in the directory c:\temp. The resource parses for files that start with “a”, followed by two numbers, each between 1 and 8, “a” OR “b”, any character and the file extension .txt.

  uxadd RES RES=D_FILE LABEL=\"file search\" nature=FIL FNAME= a[1-8][1-8][a|b].[.]txt DIR=c:\temp

  • The following files would match these criteria: a34br.txt and a51a8.txt
  • The following files would not match these criteria: a81a8.txt and a34de.txt

• Display the definition of the previously created resources:

  uxshw RES RES=D_*

• Extract all resources beginning with D_ from the current environment and archives the data in the file c:\temp\DOC.ext:

  uxext RES RES=D_* output=c:\temp\DOC.ext

• Insert all resources of file c:\temp\DOC.ext in the current environment (Company, node):

  uxins RES RES=* input=c:\temp\DOC.ext

• Delete the D_FILE resource:

  uxdlt RES RES=D_FILE

• List all resources into the file c:\temp\LstRes.txt:

  uxlst RES OUTPUT="c:\temp\LstRes.txt"