DB2 Server for VM: System Administration

ARISAVES EXEC

The VMSES/E VMFBLD exec calls ARISAVES to load and save each segment.

Figure 126. ARISAVES EXEC

>>-ARISAVES----COMPONENT(compid)---ORIGIN(origin)---------------> >-----SYSNAME(name)---+--------------+------------------------->< '-STORKEY(key)-'

COMPONENT(compid)

You must specify this parameter. It identifies the component for which a saved segment is generated. The valid values for compid are:

RA

For the resource adapter (RA), DRRM and CONV

LANGxxxx

For the national language message segment (where xxxx is the language key; LANGS001 is used for American mixed case English)

ISQL

For ISQL

DBSS

For DBSS and DSC

RDS

For RDS, WUM, DRRM and CONV

ORIGIN(origin)

You must specify this parameter. It identifies the saved segment load address, and is specified as a hexadecimal value. The ARISAVES EXEC does not check that the origins you specify give enough virtual storage to each component. However, if there is not enough room, the component is unusable.

Specify the origin that your System Programmer determined for the saved segment.

SYSNAME(name)

You must specify this parameter.

Specify the name you specified for the saved segment name in the OBJNAME field of the Add Segment Definition panel. See Chapter 8, Saved Segments. For example, SQLSQLDS for the DBSS component.

STORKEY(key)

This parameter is optional. For key, specify the storage key value (in decimal) for the saved segment.

If you omit this parameter, 13 is used for STORKEY. Normally, you would not specify this parameter.

+---------------------------VMSES/E Consideration----------------------------+

To use a different storage key, you need to change the build lists for the segments you are going to use. The following table lists the segment and their corresponding build list name.

Segment Name	Buildlist Name
SQLRMGR	ARIBLMGR
SQLISQL	ARIBLISQ
SQLSQLDS	ARIBLDBS
SQLXRDS	ARIBLRDS
LANGS001	ARIBLLNG

To change the build lists, you must use the VMSES/E local modification procedures described in the "Local Modifications for DB2 for VM" appendix in the DB2 Server for VM Program Directory.

+------------------------End of VMSES/E Consideration------------------------+

For example, to save the DBSS at origin B00000, invoke the ARISAVES EXEC as follows:

ARISAVES COMPONENT (DBSS) ORIGIN (B00000) SYSNAME (SQLSQLDS)

The ARISAVES EXEC does the following:

• Ensures the CP EMSG function is off.
• Reads the link book text file for the identified component.
• Verifies the text file exists.
• Prompts you asking whether the saved segments are to be the new default saved segments. If you reply YES, ARISAVES updates the origin values in the ARISSEGC MACRO, and generates bootstrap modules by calling the SQLBOOTS EXEC.

  The ARISSEGC MACRO identifies the contents of the default (SQLDBA) bootstrap package. For more information, see Step 12. Update the ARISSEGC Macro.

  If you reply NO, you must create a bootstrap package yourself by using the SQLGENLD EXEC shown in Step 15. Create a Bootstrap Package.

• Builds and runs a CMS LOAD command and subsequent CMS INCLUDE commands to create the saved segment at the specified origin address. All text files must reside on the service minidisk except for the text file ARIRVSTC, which must be on the production minidisk.
• Restores the original setting of the CP EMSG function.
• Prints the load map for the saved segment to a virtual print file.
• Issues a CMS SETKEY command to set the storage key for the saved segment.
• Issues a CP SAVESEG command to save the saved segment.