USERLOAD command

The USERLOAD command allows you to initially load a database faster than you can with the IMS utilities.

The USERLOAD command is required. The following keywords are optional:

  • PCB
  • PCBNAME
  • PRINT

You can also specify all of the keywords that are valid with the RELOAD command in the PLUSIN data set with the USERLOAD command, with the following exceptions:

  • CKUPDATE (any value)
  • COMPRESS (NO)
  • DYNALLOC (any value)
  • IDCAMS (any value)
  • PART (any value)
  • PDX (OKAYnnnn) or (STOPnnnn)
  • SEQERROR (ACCEPT) or (ACCEPT,nn)
  • SEGPOS (any value)

The PDX keyword is ignored. If the PDX data set is not available, the user load continues with a return code of zero. The other option values cause a user 2716 abend. The default values for the options are acceptable.

Keyword

Description

HDSORT(AUTO)

If you specify HDSORT(AUTO) or accept it as the default, the following values are used:

  • For HDAM and PHDAM databases, HDSORT(YES) is used.
  • In all other cases, HDSORT(NO) is used.

Keywords—Reload function provides a list of keywords that are valid with the RELOAD command. User-controlled-options describes the keywords.

PCB

The PCB keyword allows you to specify one or more PCBs within the PSB that the API processes. You can specify the PCB by number or DBD name. When you specify by name, the API processes the first matching occurrence of the DBD. A maximum of 255 characters is allowed for this keyword.

PCBNAME

The PCBNAME keyword provides an alternate method of specifying one or more PCBs within the PSB that the API processes. You can specify the PCB by the PCB name assigned to it in the label field or PCBNAME keyword of the PCB statement. A maximum of 255 characters is allowed for this keyword.

PRINT

The PRINT keyword prints the DL/I call, the PCB information, and the contents of the user I/O area. If you want all information (CALL, PCB, and IOAREA), specify PRINT(ALL). The information prints to the APITRACE DD statement. If you omit the PRINT keyword, the default value is ALL.

Example

The following example shows how to specify keywords for the USERLOAD command when you use the PCB keyword:

USERLOAD PCB(dbdName|pcbNumber) +
         PRINT(ALL|CALL,PCB,IOAREA)
Example

The following example shows how to specify keywords for the USERLOAD command when you use the PCBNAME keyword:

USERLOAD PCBNAME(pcbname) +
         PRINT(ALL|CALL,PCB,IOAREA)
Example

In the following example, the USERLOAD command tells the API to service all DL/I calls to the second PCB in the PSB. (The PSB is specified in the EXEC statement’s PARM.) This example also generates a printed trace of the call, PCB contents, and I/O area.

USERLOAD  PCB(2) PRINT(ALL)


Related topic

API-Reload-function


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*