DFG:Predefined Registry Settings

From Remain Software
Jump to navigation Jump to search
Translate this page

Back.gif

Predefined System Registry Settings

Saving Replaced Objects

If you want to update programs into an environment that is being used, you must instruct TD/OMS to move the objects being replaced to a different location. This is done by setting the value of registry setting OMQSAVRPLLIB to a valid library name on the system where you want this to happen. If the library does not exist it is created. QRPLOBJ (The library being used by IBM when a program is created with REPLACE(*YES)) is not a bad choice. In addition to this, you have to set the value of OMQSAVRPLTYPES with a list of object types to save.

Please note that manual maintenance of any other library than QRPLOBJ is required. You should empty this library after an IPL.

The registry setting is global. It cannot be specified for a specific application or environment.

OMQSAVRPLLIB - Save Replaced Objects Library

Contains the library that is used to store replaced objects in. Could be QRPLOBJ. Please note that QRPLOBJ is in the system ASP. In case of an iASP the library is called QRPLxxxxx (where xxxxx is the number of your iASP).If you have 1 iASP than the library will most likely be QRPL00033. Moving objects across ASP's is not possible. TD/OMS will generate the fallback library in the iASP so you need to use the iASP equivalent of QRPLOBJ or your own library in the same iASP.

Example
OMQCHGSR ACTC(*ADD) KEYW(OMQSAVRPLLIB) KEYV(QRPLOBJ)

OMQSAVRPLTYPES - Save Replaced Objects Types

Contains a list of comma separated object types that must be saved when replaced. E.g. *PGM, *SRVPGM, *USRSPC

Example
OMQCHGSR ACTC(*ADD) KEYW(OMQSAVRPLTYPES) KEYV('*PGM, *SRVPGM')

Since
This setting is active in version V5.1M04 and higher

OMQILEPRC - Automatically update programs and service programs

If this registry setting is set for a specific application and environment combination then every module and service program that is processed automatically updates the program or service program with the new module or service program by using the UPDPGM and UPDSRVPGM commands. Please see the UPDILEOMS command for more information.

Example
OMQCHGSR ACTC(*ADD) APPL(required application) ENVC(required environment) KEYW(OMQILEPRC) KEYV('1')

Since
This setting is active in version V5.1M04 and higher

OMQPRDDLTLOCK - Disallow Delete Object and Source from Production Environments

If an object is disconnected from the fix, or if the user uses option 4=Delete in Object Maintenance, the option to also remove the object and source is shown. This is often not desirable in a production environment and is potentially dangerous. Note that removing objects from production is only allowed to Application Managers and owners of the production environment. If you want to inhibit this behavior altogether for production environments then set this registry entry. Please note that the user is still invited to delete object and source but gets a message if the flag is set.

Since
This setting is active in version V5.1M07 and higher.

OMQPRDDLTLOCK - Production delete lock

Contains '1' if the lock is active.
Contains '0' if the lock is not active
The effect of any other value is not defined.

Create the registry setting like this:

OMQCHGSR ACTC(*ADD) APPL(optional application) KEYW(OMQPRDDLTLOCK) KEYV('1')

OMQALWOBJREG - Allow Object Registration

This routine checks if it is possible to register an object in the database outside of the regular object registration functions. This prevents objects to be introduced outside certain allowed environments.

The check is done by querying OMQALWOBJREG. This registry setting can be set system-wide, per application or per environment. The value can be: 

*DEVONLY - Only allowed in development environments
*NO      - Not allowed for this system/application/environment
*YES     - Allowed for this system/application/environment

Finer definitions take preference over global definitions meaning that environment specifications override application specifications which in turn override system-wide specifications.

Since
This setting is active in version V5.0M12 and higher.

Create the registry setting like this:

OMQCHGSR ACTC(*ADD) APPL(optional application) ENVC(optional environment) KEYW(OMQALWOBJREG) KEYV('*DEVONLY')

OMQALWOBJREFILL - Allow Object Change

This setting disables the possibility to refresh the status of an object in the database outside of the regular object registration functions. This prevents objects to be changed by outside forces (e.g. recompiled) outside certain allowed environments.

The check is done by querying OMQALWOBJREFILL. This registry setting can be set system-wide, per application or per environment. The value can be: 

*DEVONLY - Only allowed in development environments
*NO      - Not allowed for this system/application/environment
*YES     - Allowed for this system/application/environment

Finer definitions take preference over global definitions meaning that environment specifications override application specifications which in turn override system-wide specifications.

Since
This setting is active in version V5.0M12 and higher.

Create the registry setting like this:

OMQCHGSR ACTC(*ADD) APPL(optional application) ENVC(optional environment) KEYW(OMQALWOBJREFILL) KEYV('*DEVONLY')

Transfers only allowed in batch

Set registry key BATCHONLY to '1' in order to activate the setting. This keyword must be set in combination with the application code and the program code.

BATCHONLY - Batch transfers only

OMQCHGSR ACTC(*ADD) APPL(DEMO) PGMN(OMO001) KEYW(BATCHONLY) KEYV('1')

Force usage of connection rules

Forces the use of connection rules. The GUI will not allow connecting without rules if this flag is set. In the green screen, even if the user uses '1=Select' in the object maintenance function, the connection rules are activated.

FORCECONNRULE - Force Connection Rules

OMQCHGSR ACTC(*ADD) APPL(DEMO) KEYW(FORCECONNRULE) KEYV('1')

Confirming a Transfer

If you want a validation of the user before a transfer takes place, you are able to specify this in registry key CONFIRMTRANSFER. This will instruct TD/OMS to ask for the password of the current logged in user to ensure that this is actually the user that started the transfer.

CONFIRMTRANSFER - Confirm Transfer

Green Screen

  • OMQCHGSR ACTC(*ADD) APPL(DEMO) PGMN(OMO001) KEYW(CONFIRMTRANSFER) KEYV('0')
    Transfers do not need to be confirmed.
  • OMQCHGSR ACTC(*ADD) APPL(DEMO) PGMN(OMO001) KEYW(CONFIRMTRANSFER) KEYV('1')
    All transfers must be confirmed by entering the user's password.

GUI

  • OMQCHGSR ACTC(*ADD) APPL(DEMO) PGMN(OMX943) KEYW(CONFIRMTRANSFER) KEYV('0')
    Transfers do not need to be confirmed.
  • OMQCHGSR ACTC(*ADD) APPL(DEMO) PGMN(OMX943) KEYW(CONFIRMTRANSFER) KEYV('1')
    All transfers must be confirmed by entering the user's password.

Keep the source date

This setting instructs TD/OMS not to change the source change date of the member being transferred. This is achieved by employing save/restore rather than CPYSRCF to copy a source member. In order for this to work, the from and to file must be of the same level. This means that keeping the source date does not work if the record lengths differ between source files.

KEEPSOURCEDATE - Keep the source date

  • OMQCHGSR ACTC(*ADD) KEYW(KEEPSOURCEDATE) KEYV('0')
    The sourcedate does not need to be kept in the source member. TD/OMS will guard the source change date in its database.
  • OMQCHGSR ACTC(*ADD) KEYW(KEEPSOURCEDATE) KEYV('1')
    Try to do a save and restore to keep the source date. If this is not possible then ignore the error and try to copy the source file with CPYF which will change the source change date information in the sourcemember.
  • OMQCHGSR ACTC(*ADD) KEYW(KEEPSOURCEDATE) KEYV('2')
    Try to do a save and restore to keep the source date. If this is not possible then an error is reported that will start fall-back processing.

Since

This setting is NOT active anymore in version V6.4M00 and higher.
As of IBM i/OS V6R1M0 this is solved in the CPYSRCF command.
For IBM i/OS V5R4M0 PTF SI25844 is required.
For IBM i/OS V5R3M0 PTF SI25796 is required.

AS/SET System libraries

In case your AS/SET libraries are not ASSETO or ASSETF then you can change this by setting registry entries per application.

OMASSETO - Set the AS/SET object library

  • OMQCHGSR ACTC(*ADD) APPL(appl) KEYW('OMASSETO') KEYV(value)

OMASSETF - Set the AS/SET file library

  • OMQCHGSR ACTC(*ADD) APPL(appl) KEYW('OMASSETF') KEYV(value)
    Sets the AS/SET file library to a different value.
ASSETGPL cannot be changed. Please contact us if you need this.

OMSCOPLIMLF - Logical File Creation Scope Limit

  • OMQCHGSR ACTC(*ADD) APPL(appl or blanks for all applications) ENVC(environment or blanks for all environments) KEYW('OMSCOPLIMLF ') KEYV(0, 1 or 2)

The keyword restricts the library list scope of the logical file creation. If the value is not found then TD/OMS will use the standard way of creating a logical. This standard process includes a search of all environments until the correct or most probable physical file has been found. If the logical resides in an intermediate environment then all higher environments will be searched for the associated physical but never the production locations.

The possible values for KEYV are:

  • 0 - Library
    Only build logicals over physicals in the same library.
  • 1 - Library List (Sub-environment)
    Only build logicals over physicals in the same library list or sub-environment.
  • 2 - Environment
    Logicals can be build over any physical in the same environment.


Since
This setting is active in version V5.1M07 and higher.

OMIFSSRCEXT - Stream File extension definition for Source data save

  • OMQCHGSR ACTC(*ADD) APPL(appl or blanks for all applications) ENVC(only *NONE) ROTC(route or blanks for all Routes) KEYW('OMIFSSRCEXT ') KEYV(any character string representing one or a series of file extension types or *ALL for all stream files)

Determines the extension type of Stream Files for which contents (source) save in an archive file will be activated. The source save procedure will be processed when the file component is transferred to the lowest (development or emergency) environment in the Application. If a KEYV has to be defined for a series of file extensions, remind that the first four positions of the extension string will be compared with blocks of maximal four characters in the file extension definition string.


Since
This setting is active in version V5.1M13 and higher.

OMQINLLIBL - Initial Library List For Batch Jobs

Sets the library list to be used with batch jobs submitted by TD/OMS: the value is used for the INLLIBL parameter on the SBMJOB-command. If this entry is not registered in the TD/OMS System Registry, the value *CURRENT is used (this value is also used in all versions before V51KEM11). The value can be specified as follows:

  • OMQCHGSR ACTC(*ADD) APPL(application | *NONE) KEYW(OMQINLLIBL) KEYV(*CURRENT | *JOBD | *SYSVAL | *NONE)

The possible values for KEYV are all described in the help panel of the command SBMJOB. Only the single values are allowed: specifying a list of libraries is not possible. The listed valid values are valid for IBM i V5R1M0; the list may be extended in future releases.


When TD/OMS submits a batch job, the value for INLLIBL is determined in three steps:

  1. Retrieve the value of OMQINLLIBL for the current application
  2. If not found, retrieve the global value of OMQINLLIBL (application code is *NONE)
  3. If not found, use *CURRENT


Step 1 is skipped for jobs that are not dependent on any application, like Reorganize Files. It is not possible to define a value for a specific environment within an application.


Since
This setting is active in version V5.1M11 and higher.

OMQFALBCKUSRX - Fall Back User Exit program

If you want to trigger a user defined program after a Fall Back has been executed, you should use this registry setting. If the call to the program defined fails a message is sent to the TD/OMS log.

  • OMQCHGSR ACTC(*ADD) APPL(appl or blanks for all applications) KEYW('OMQFALBCKUSRX') KEYV(program name)

The program is called with the following parameter list:

  • Transfer code (8 character)
  • Application (5 character)
  • From environment code (5 character)
  • To environment code (5 character)
  • Status (5 character)


Since
This setting is active in version V5.1M13 and higher.

OMSCANPHASES - Scan source relationship

Scan the source relationship based on the number of phases. This registry setting can be set system-wide, per application, or per environment. The value can be: 

01 - To scan for included files (like copymembers) and external data structures only.
02 - To scan for fields.
The higher the number the slower the relationship processing will be but the more information can become available.

Since
This setting is active in version V5.3M00 and higher.

OMQPRCLODINT - Load internal ILE procedures in TD/OMS relation database

If you want to load the internal ILE procedures into the TD/OMS relation database, you should use this registry setting.

  • OMQCHGSR ACTC(*ADD) APPL( blanks) KEYW('OMQPRCLODINT') KEYV(1)

Since
This setting is active in version V6.0M02 and higher.


OMQRMTJOBMONUSR - Remote Job Monitor User

If you have set-up TD/OMS with another TD/OMS system user then the default user profile OMS and you want to use Remote Job Monitor functions, you should use this registry setting. This registry setting must be set on the local machine and on the receiving machine(s).

  • OMQCHGSR ACTC(*ADD) KEYW('OMQRMTJOBMONUSR') KEYV(TD/OMS system user profile)

Since
This setting is active in version V6.0M03 and higher.

OMQLODSQLOBJ - Load SQL Objects in TD/OMS

If you want to load the SQL long names of database objects and to see the relations with their counterpart native implementation, you shoulf use this registry setting. The loaded SQL objects cannot be used as a solution in TD/OMS and therefore the SQL objects cannot be maintained with TD/OMS.

  • OMQCHGSR ACTC(*ADD) APPL(appl) ENVC(environment code or blanks for all environments) KEYW('OMQLODSQLOBJ') KEYV('1')

Since
This setting is active in version V6.0M03 and higher.

OMQGUIDIAPORT - GUI Dialog Server Port

If you want to be able to start a dialog with a client running the TD/OMS GUI, you have to specify a TCP/IP port with this registry key. After the port is changed, clients must restart in order to listen to the new port.

  • OMQCHGSR ACTC(*ADD) KEYW('OMQGUIDIAPORT') KEYV('01234')

Replace '01234' with the required port. Please use 5 positions.

Since
This setting is active in version V6.4M00 and higher.

OMQRATFIX - Ratification Fix setting

  • OMQCHGSR ACTC(*ADD) APPL(appl or blanks for all applications) ENVC(environment or blanks for all environments) KEYW('OMQRATFIX') KEYV(0, 1 or 2)

Determines the way the ratification authority validation is executed. If the value is not found then TD/OMS will use the classic way of ratification authority validation.

The possible values for KEYV are:

  • 0 - Any user can ratify a fix.
    Any user who is a member of the ratification group can ratify the fix.
  • 1 - User can not ratify his own fix.
    Any user who is a member of the ratification group can ratify the fix, except if the user is the programmer of the fix.
  • 2 - Only user can ratify his own fix.
    Any user who is a member of the ratification group can only ratify their own fixes.

Since
This setting is active in version V6.4M00 and higher.

OMQDSTPROFILE - OMS Distribution Profile

  • OMQCHGSR ACTC(*ADD) KEYW('OMQDSTPROFILE') KEYV([user profile|*CURRENT])

This user profile is used to perform TD/OMS distributions. If this registry setting is not defined it is taken from the owner of the file OMOBJ. This is normally the user OMS. However, on systems with more then one OMS installation you could need a different profile.

The possible values for KEYV are:

  • user profile
    Specify the user profile to be used for distributions.
  • *CURRENT
    The current user profile is used.

Since
This setting is active in version V6.4M00 and higher.

OMQTCPSYSNAME - OMS TCP Distribution System Name

  • OMQCHGSR ACTC(*ADD) KEYW('OMQTCPSYSNAME') KEYV(System name)

This system name is used to send back the messages needed for the remote job monitor mechanism when the TD/OMS TCP distribution is used. If this registry setting is not defined the local location name from the network attributes is used. This registry setting should only be used when the local location name (on the remote system) does not match the hostname used for TCP communication.

The possible values for KEYV are:

  • System Name
    Specify the system name used for TCP communication.

OMQSOCSRMV - Remove Solution After Split

  • OMQCHGSR ACTC(*ADD) KEYW('OMQSOCSRMV') APPL(application) KEYV('1')

The user option CS from supplied user option program OMUSROPTSO (source resides in QUSRSRC) is able to move a solution from one fix to another.

The possible values for KEYV are:

  • 1
    The solution is removed after it was successfully attached to the new fix.
  • other then 1 or not defined
    The solution stays connected to the old fix as a *FOLLOW solution

Since
This setting is active in version V6.4M00 and higher.

OMQAUTREFTYP - Adopt Authorization from OMSREFOBJ with specific object type

  • OMQCHGSR ACTC(*ADD) APPL(appl or blanks for all applications) ENVC(environment or blanks for all environments) KEYW('OMQAUTREFTYP') KEYV(0 or 1)

If in the Application Definition the authority conversion type is set to value 1=adopt or 2=OMSREFOBJ, TD/OMS tries to adopt the authority from object OMSREFOBJ with type *DTAARA. This registry setting makes it possible adopt the authority from object OMSREFOBJ with a specific object type.

The possible values for KEYV are:

  • 1  : The authority is adopted from object OMSREFOBJ with the specific object type if it exists, otherwise it is adopted from object OMSREFOBJ with type *DTAARA.

Since
This setting is active in version V6.5M04 and higher.

OMQDISTR1ADDR - Distribution object set per address

  • OMQCHGSR ACTC(*ADD) APPL(application or blanks for all applications) ENVC(environment or blanks for all environments) KEYW('OMQDISTR1ADDR') KEYV(0 or 1)

According to default processing, TD/OMS creates one distribution set with all objects involved in a transfer and sends this set to all the addresses selected within that transfer. On the receiving systems, the final selection is made which objects should be processed at the specific address and which can be skipped according to conditions and selections in the environment definitions.

If the requirement is to restrict the distribution set to only those objects that have been really passed selection criteria for the specific address, this registry setting must be activated.


The possible values for KEYV parameter are:

  • 1  : The object distribution set is restricted to objects filtered for the specific sub-environment.
  • 0  : The object distribution set is created for all addresses at once.

Since
This setting is active in version V6.5M05 and higher.

OMQDISTRBASEDIR

  • OMQCHGSR ACTC(*ADD) KEY('OMQDISTRBASEDIR') VALUE('path/to/dir')

This keyword is automatically set when the INZOMSSVR command is run. It contains the base queuing directory for this installation.

TD/OMS Compilation settings

OMQCOMPJOBD - Compilation Job Description

OMQCHGSR ACTC(*ADD) APPL(application or blanks for all applications) ENVC(environment or blanks for all environments) KEYW('OMQCOMPJOBD') KEYV('*LIBL     YOURJOBD  ')

If you use the TD/OMS compile in batch function the TD/OMS compile command is submitted to batch with the job description from the user. If you want to use a specific job description for TD/OMS batch compiles, you should use this registry setting. This job description is used for sequential compiles. Some object types can be compiled in parallel, for this, take a look at registry setting OMQCOMPJOBDP.

The key value first ten positions must contain the job descriptions library and the key value positions 11-20 must contain the job description name.

If you want to activate parallel compiles then see also

  • OMQCOMPJOBDP
  • OMQCOMPPRCSEQ

Since
This setting is active in version V6.5M00 and higher.

OMQCOMPJOBDP - Job Description for Parallel Compilation

  • OMQCHGSR ACTC(*ADD) APPL(application or blanks for all applications) ENVC(environment or blanks for all environments) KEYW('OMQCOMPJOBDP') KEYV('*LIBL YOURJOBD ')

If you use the TD/OMS compile in batch function the TD/OMS compile command is submitted to batch with the job description from the user. If you want to take advantage of the parallel compile function, you should use this registry setting. This job description is used for parallel compiles and is used in combination with OMQCOMPJOBD. Define a job description which uses a jobqueue for which multiple jobs can be active at the same time.

The key value first ten positions must contain the job descriptions library and the key value positions 11-20 must contain the job description name.

See also

  • OMQCOMPJOBD
  • OMQCOMPPRCSEQ

Since
This setting is active in version V11.0M01 and higher.

OMQCOMPPRCSEQ - Parallel Compilation Processing Sequence

  • OMQCHGSR ACTC(*ADD) KEYW('OMQCOMPPRCSEQ') KEYV(Processing Sequence Number)

If you use the TD/OMS parallel compilation functionality then you will have to use this registry setting. If you don't specify the processing sequence number then it would pick 67500 as a default processing number.

If the objects processing sequence value is less than the specified number then compile jobs will be submitted in the job queue specified in OMQCOMPJOBD. Otherwise, jobs will be submitted in a parallel queue which is specified by setting OMQCOMPJOBDP. The processing sequence can be changed here.

See also

  • OMQCOMPJOBD
  • OMQCOMPJOBDP


Since
This setting is active in version V11.0M01 and higher.

OMQAUTIFSDIR - Stream file authorization from target directory

  • OMQCHGSR ACTC(*ADD) APPL(application or blanks for all applications) ENVC(environment or blanks for all environments) KEYW('OMQAUTIFSDIR') KEYV(0, 1 or 2)

According to default processing TD/OMS creates stream file objects with the authority settings from the from object (see parameter AUT(*OBJ) on the CPY command). If the requirement is to create stream file objects with authority settings from the directory it is created in, this registry setting must be activated.


The possible values for KEYV parameter are:

  • 0  : The stream file object is created default with authority (like parameter AUT(*OBJ) on the CPY command).
  • 1  : The stream file object is created default with authority from the target directory (like parameter AUT(*INDIR) on the CPY command).
  • 2  : The stream file object is created default with authority from the target directory and the from object (like parameter AUT(*INDIROBJ) on the CPY command).

WARNING: Using a 2 on a receiving system may give unexpected results as the authorizations of the TD/OMS receiving directory (which is a temporary directory) are also taken into account.

Since
This setting is active in version V6.5M05 and higher, also IBM i/OS V6R1M0 or higher is required.

OMQAUTPGMRCHG - Authorisation for fix programmer change

  • OMQCHGSR ACTC(*ADD) APPL(application or blanks for all applications) ENVC(environment or blanks for all environments) KEYW('OMQAUTPGMRCHG') KEYV(3)

This registry setting can be used to prevent the change of the fix programmer.

If it is required to prevent programmers to assign their own fixes to another programmer this registry setting must be activated.


The possible values for KEYV parameter are:

  • 3  : The fix programmer can only be changed by users with authorization code 3.

Since
This setting is active in version V9.0M01 and higher.

OMQWORKDIRCANDM - Work directory for compare and merge

  • OMQCHGSR ACTC(*ADD) KEYW('OMQWORKDIRCANDM') KEYV('/QOpenSys/TD/tmp/CMWDIR')

This registry setting can be used to point to a new working directory for source compare and merge.

If this key is not defined, programs should assume the default value of '/QOpenSys/TD/tmp/CMWDIR'.

Since
This setting is active in version V9.0M01 and higher.

OMQ4GLGENOBJ - Scope limit for generated objects check

  • OMQCHGSR ACTC(*ADD) APPL(application) KEYW('OMQ4GLGENOBJ') KEYV('FIX') or 'TFR'

see: 2E scope limit for generated objects check

OMQGITURL - Git base URL

This registry setting is used as the URL for the Git repository of the route of this application. This registry setting is automatically set by the INZGITOMS command. If you manually import your sources you have to manually set the values below as well.


Since
This setting is active in version V9.1M00 and higher.

OMQOMSGITDIR - TD/OMS Git Script Directory

  • OMQCHGSR ACTC(*ADD) KEYW('OMQOMSGITDIR') KEYV('/QOpenSys/TD/Git/')

This registry setting is used to indicate the directory where the Git scripts are saved. This setting is automatically created when command INZOMSSRV *GIT is performed.


Since
This setting is active in version V9.1M00 and higher.

OMQGITPRCRTE - GIT Process Route code

  • OMQCHGSR ACTC(*ADD) APPL(<application>) KEYW('OMQGITPRCRTE') KEYV(<route>)

This registry setting is used to define the TD/OMS route code where the IBM i sources can be found. Use this registry setting when your IBM i sources are managed by TD/OMS and Git to indicate additional processing (connect objects to a task when checking in an IFS source. See the Git manual for more information. This registry setting is automatically set by the INZGITOMS command. If you manually import your sources you have to manually set the values below as well.

Since
This setting is active in version V10.0M01 and higher.


OMQGITAMSTRPUSH - GIT Allow Push to Master

  • OMQCHGSR ACTC(*ADD) APPL(<application>) RPTC(<route>) KEYW('OMQGITAMSTRPUSH') KEYV(<0|1>)

This registry setting is used to define if you allow (1) a direct push to master for the specified route. The default value is not to allow a direct push (2) but use feature branches.

Since
This setting is active since version V10.0M02

OMQEXTCMPLIBL - Extended Compilation library list

  • OMQCHGSR ACTC(*ADD) KEYW('OMQEXTCMPLIBL') KEYV('1')

This registry setting is used to define that the Environment Compilation library lists are extended with additional libraries to locate object relations outside the active, current TD/OMS application. When using this option all applications involved in the relationship search must be classified in Application Group definitions.


Since
This setting is active in version V10.1M00 and higher.

OMQOPENAPIRTE - Route for OpenAPI Generation

  • OMQCHGSR ACTC(*ADD) KEYW('OMQOPENAPIRTE') KEYV(<route code>)
  • OMQCHGSR ACTC(*ADD) APPL(<application>) KEYW('OMQOPENAPIRTE') KEYV(<route code>)

This registry setting is used to define where OpenAPI specifications have to be generated. This can be set on the application level or on the system level. Application level will take precedence over system level.

Since
This setting is active in version V10.0M03 and higher.


OMQJRNWRKLIB - Work Library for Journal Analyzer

  • OMQCHGSR ACTC(*ADD) KEYW('OMQJRNWRKLIB') KEYV(<Work Library Name>)

This registry setting is used to define the library where temporary information would be stored. Please specify the value of "<Work Library Name>" accordingly. The contents of this library may grow but can be discarded at any time. QTEMP will not work.


Since
This setting is active in version V11.0M01 and higher.

OMQTESTOBJREGEX - Test Objects Regex

  • OMQCHGSR ACTC(*ADD) APPC(<application|empty>) KEYW('OMQTESTOBJREGEX') KEYV(<valid java regex>)

This registry setting is used to identify programs and service programs that are test objects. These objects will be folded in the Work Management tree under the Test node. Enter a valid java regular expression on the system level or fill in a specific application code to override the system level. The default value is "(TS.*|.*TST.*)".

The objects are matched against a qualified name. For example, the qualified name for an RPGLE program object is NAME.PGM.RPGLE. If you only want RPGLE objects to match as test objects, the regex could be TST.*RPGLE$ which matches all objects starting with TST and ending in RPGLE.

Changes in this setting are active after restarting the GUI.


Since
This setting is active in version V12.0M01 and higher.


OMQJOBLOGGEN - Generate Job Log after GUI Call

  • OMQCHGSR ACTC(*ADD) KEYW('OMQJOBLOGGEN') KEYV('OMC022')

This registry setting is used to determine which TD/OMS programs must generate a job log after being called from the GUI. The default program is OMC022 which is used to interactively compile an object. The program names must be uppercase and separated by a space.

Changes in this setting are active after the GUI is restarted.

Since
This setting is active in version V12.1M00 and higher.


OMQLINKPREFIX - Generated Tracker Link Prefix

When a Task or Request is connected to a tracker item like Jira or Gravity, a backlink is generated in the tracker item. This registry setting is used to define a custom link that is used as a prefix for the generated tracker backlink to TD/OMS. The total link length should be 150 positions or less.

Syntax:

  • OMQCHGSR ACTC(*ADD) KEYW('OMQLINKPREFIX') APPC(*NONE|_application_) PGMN(*NONE|'TASK'|'REQUEST') KEYV(_url_)

'TASK' and 'REQUEST' are literals.

You can define the variable multiple times in different combinations. Consider the following entries (stored in table OMAGP)

Table OMAGP
Entry APPC PGMN KEYV
1 *NONE TASK https://octo.remainsoftware.com/org/remain?handle=tdoms/tasks/{application}/{number}
2 *NONE REQUEST https://octo.remainsoftware.com/org/remain?handle=tdoms/request/{application}/{number}
3 ORDER *NONE https://order.remainsoftware.com/org/remain?handle=orders/?number={number}&application={application}
4 *NONE *NONE https://octo.remainsoftware.com/welcome.html/?type={type}&number={number}&application={application}

The following search order will be used:

  1. Application / Type
  2. Application / *NONE
  3. *NONE / Type
  4. *NONE / *NONE


Given application 'TEST' Type='TASK' and the Task number='T0001'
Entry 1 is taken because it is the only entry that matches application 'TEST' and type 'TASK' 

https://octo.remainsoftware.com/?handle=tdoms/tasks/TEST/T0001


Given application 'ORDER' Type='TASK' and the Task number='T0001'
Entry 3 is taken over entry 1 because the application takes precedence. 

https://order.remainsoftware.com/?handle=orders/?number=T0001&application=ORDER


Given application 'BOOK' Type='REQUEST' and the number='R9999'
Entry 2 matches 'Request' and application 'BOOK' does not have a key. 

https://octo.remainsoftware.com/?handle=tdoms/request/BOOK/R9999


Entry 4 is used only in cases where the type will not be 'Task' or 'Request'. This situation does not occur.


You can use the following variables:

{type}
'Task' or 'Request'
{number}
The Task or Request number
{application}
The Application code


Changes in this setting are active after the GUI is restarted.

Since
This setting is active in version V14.0M01 and higher.

OMQFLBCOPYTYPES - Copy or Move the object to fall-back library

  • OMQCHGSR ACTC(*ADD) KEYW(OMQFLBCOPYTYPES) KEYV('*PGM *SRVPGM')
    This registry setting is used during the promotion. The object type is matched with the value of the OMQFLBCOPYTYPES keyword, it contains a space-separated list of object types. If a match is successful, the object is copied to the fallback library else it is moved.

Since
This setting is active in version V14.0M03 and higher.

OMQUSRDTALIB - User Session Data library

The OMQUSRDTALIB setting controls the location of the OMS user session data. When this registry setting is used, it can point to a library where the session data must be stored. The special value *OMSLIB is used to point to the OMS library. This entry is required if you use the TD/OMS REST API.


Since
This setting is active in version V14.1M00 and higher.

OMQCREATEBRANCH - Automatic Branch Creation

  • OMQCHGSR ACTC(*ADD) APPL(optional application) KEYW(OMQCREATEBRANCH ) KEYV('1')

This registry setting activates automatic branch creation when a new task is added.

The possible values for KEYV are:

  • 1

The branch will be created automatically.

  • other than 1 or not defined

The branch will not be created automatically.


Since
This setting is active in version V15.0M01 and higher.

OMQAUTOTSKREQNR - Fill the task and request number automatically

  • OMQCHGSR ACTC(*ADD) KEYW(OMQAUTOTSKREQNR) KEYV('1')

This registry setting is used to automatically fill the task and request number from a ticket.

The possible values for KEYV are:

  • 1

The task and request number will be filled out automatically.

  • other than 1 or not defined

The task and request number will not be filled out automatically.

Since
This setting is active in version V15.0M01 and higher.

OMQRMTJDBSYNDFT - Local job descriptions automatically synchronize the remote job descriptions

  • OMQCHGSR ACTC(*ADD) APPL(<application|empty>) ENVC(<environment|empty>) KEYW(OMQRMTJDBSYNDFT) KEYV('1')

When the user sets the local job description during transfer, then the remote job descriptions are automatically switched to the same value when this registry is active. You can override this value at three different levels.

The possible values for KEYV are:

  • 1

Synchronize.

  • other than 1 or not defined

Do not synchronize.

Since
This setting is active in version V15.0M02 and higher.

OMQJWTSECRET- This registry setting is used to store the JWT secret key

  • OMQCHGSR ACTC(*ADD) KEYW(OMQJWTSECRET) KEYV('<secret key>')

This registry setting stores the JWT secret key, which is used to generate JWT tokens. If this key cannot be found when the JWT key generation process needs it, it is automatically generated.

Since
This setting is active in version V15.0M02 and higher.

OMQJWTEXP - JWT expiration time in seconds

  • OMQCHGSR ACTC(*ADD) KEYW(OMQJWTEXP) KEYV(numeric value)

Defines the JWT expiration time in seconds. It defauls to 43200 seconds (12 hours).

Since
This setting is active in version V18.0M01 and higher.

OMQSSHXFRDIR - The location of the SSH Transfer server

  • OMQCHGSR ACTC(*ADD) KEYW(OMQSSHXFRDIR) KEYV('/QOpenSys/TD')

This registry setting is used to store the location of the SSH Transfer server. This key is installation-wide and is set automatically by the installation process.

Since
This setting is active in version V15.0M03 and higher.


OMQWSWEBPATH - The location of the WebSmart Web Path

  • OMQCHGSR ACTC(*ADD) KEYW(OMQWSWEBPATH) KEYV('http:\/\/100.64.64.40\/&OBJL\/&OBJC.pgm')

Stores the web path template for WebSmart. This path should be 'regex save,' meaning that special regex characters must be escaped with '\' as seen in the above example. The variables &OBJL and &OBJC can be placed in the path. See the online WebSmart manual for details.

Since
This setting is active in version V15.1M00 and higher.

OMQTRACKERURL - Default Tracker URL

This setting stores the default tracker URL. The URL is prefilled with this value when a new tracker server is created.

Since
This setting is active in version V16.0M01 and higher.

Use the STRARM function to add the registry setting or create the registry setting from the command line like this:

OMQCHGSR ACTC(*ADD) PGMN(server) KEYW(OMQTRACKERURL) KEYV(server-url)

Replace server with the following keywords:

  • AZD (Azure Devops)
  • BBCLOUD (BitBucket Cloud)
  • BBSERVER (BitBucket Server)
  • CW (ConnectWise)
  • GITHUB
  • GITLAB
  • GRAVITY
  • JIRA
  • OTRS
  • SDP (ServiceDesk Plus)
  • SERVICENOW
  • ZENDESK

This list is not exhaustive. If your tracker is not listed, don't hesitate to contact us.

OMQDFTSRCFLEN - Default length for new source files

  • OMQCHGSR ACTC(*ADD) KEYW(OMQDFTSRCFLEN ) KEYV('112')

This registry setting sets the new default source file length if a new source file must be created.

The value must be a numeric integer value.

Since
This setting is active in version V15.1M01 and higher.

OMQUNAUTCOMPILE - Unauthorized compile command

This setting controls the unauthorized compile overrides command during the transfer.

  • OMQCHGSR ACTC(*ADD) KEYW(OMQUNAUTCOMPILE) KEYV(*WARN)

When set, log a warning message.

  • OMQCHGSR ACTC(*ADD) KEYW(OMQUNAUTCOMPILE) KEYV(*NONE)

When set, unauthorized compile commands are not reported.

  • OMQCHGSR ACTC(*ADD) KEYW(OMQUNAUTCOMPILE) KEYV(*ERROR)

When set, an error is logged and the object is not transferred to the target environment. The transfer starts the rollback procedure if rollback is required for the target environment.

Since
This setting is active in version V16.0M01 and higher.

OMQDSTSVDTACPR - Data compression for save files

This system-wide setting controls the compression of the savefile sent to the other machines. The value must be any of the values in the SAV commands for the DTACPR keyword. When not specified the value will be *YES.

Example
OMQCHGSR ACTC(*ADD) KEYW(OMQDSTSVDTACPR) KEYV(*ZLIB)


Since
This setting is active in version V16.0M03 and higher.

OMQDSTSVCOMPACT - Data compaction for save files

This system-wide setting controls the compaction of the savefile sent to the other machines. The value must be any of the values in the SAV commands for the COMPACT keyword. When not specified the value will be *DEV.

Example
OMQCHGSR ACTC(*ADD) KEYW(OMQDSTSVCOMPACT) KEYV(*NO)


Since
This setting is active in version V16.0M03 and higher.

OMQOCTOORG - Link to your OCTO organization

This system-wide setting contains the link to your OCTO organization.

Example
OMQCHGSR ACTC(*ADD) KEYW(OMQOCTOORG) KEYV('https://octo.remainsoftware.com/org/remain')

Since
This setting is active in version V17.0M02 and higher.

OMQDEPLOYCTL - Deployment control

This registry setting determines whether the transfer is done through the Managed Deployment system or directly to the remote. If this setting is enabled, deployments are managed, otherwise, the deployment is immediate.

Example
OMQCHGSR ACTC(*ADD) APPL(XMP) KEYW(OMQDEPLOYCTL) KEYV(0)

Deployments are immediate.

Example
OMQCHGSR ACTC(*ADD) APPL(XMP) KEYW(OMQDEPLOYCTL) KEYV(1)

The transfer is managed. It is placed in a staging area for further processing.

Since
This setting is active in version V17.0M03 and higher.

OMQCGITEMPLIB - CGi State Library

This registry setting specifies the library used by the TD/OMS Rest service to store program state.

Example
OMQCHGSR ACTC(*ADD) KEYW(OMQCGITEMPLIB) KEYV(OMSCGIWORK)

You can specify your own library to store source changes when saving. The library must be created before using the TD/OMS Rest Service and public access must be *USE. If no custom library is set in the registry, the default library OMSCGIWORK will be used.

Since
This setting is active in version V18.0M01 and higher.