Loads symbol information for one or more shareable images and
    establishes the current image.

    Format

      SET IMAGE  [image-name[, . . . ]]

1  –  Parameters

 image-name

    Specifies a shareable image to be set. Do not use the asterisk
    (*)  wildcard character. Instead, use the /ALL qualifier. Do not
    specify an image name with /ALL.

2  –  Qualifiers

2.1    /ALL

    Specifies that all shareable images are set.

3  –  Description

    The SET IMAGE command builds data structures for one or more
    specified images but does not set any modules within the images
    specified.

    The current image is the current debugging context: you have
    access to symbols in the current image. If you specify only one
    image with the SET IMAGE command, that image becomes the current
    image. If you specify a list of images, the last one in the list
    becomes the current image. If you specify /ALL, the current image
    is unchanged.

    Before an image can be set with the SET IMAGE command, it must
    have been linked with the /DEBUG or /TRACEBACK qualifier on the
    DCL command LINK. If an image was linked /NOTRACEBACK, no symbol
    information is available for that image and you cannot specify it
    with the SET IMAGE command.

    Definitions created with the DEFINE/ADDRESS and DEFINE/VALUE
    commands are available only when the image in whose context they
    were created is the current image. When you use the SET IMAGE
    command to establish a new current image, these definitions are
    temporarily unavailable. However, definitions created with the
    DEFINE/COMMAND and DEFINE/KEY commands are available for all
    images.

    Related commands:

       SET MODE [NO]DYNAMIC
       (SET,SHOW,CANCEL) MODULE
       (SHOW,CANCEL) IMAGE

4  –  Example

  DBG> SET IMAGE SHARE1
  DBG> SET MODULE SUBR
  DBG> SET BREAK SUBR

      This sequence of commands shows how to set a breakpoint on
      routine SUBR in module SUBR of shareable image SHARE1. The SET
      IMAGE command sets the debugging context to SHARE1. The SET
      MODULE command loads the symbol records of module SUBR into
      the run-time symbol table (RST). The SET BREAK command sets a
      breakpoint on routine SUBR.