REFRESH

Read syntax diagramSkip visual syntax diagram REFResh LOGOinfofnftLOGOVSMuserid

Authorization

Privilege Class: A

Purpose

Use REFRESH to replace the existing logo configuration file maintained by CP or to tell CP to send new LOGO information to one or more VTAM® service machines (VSM).

Operands

LOGOinfo fn ft
tells CP to replace the existing logo configuration file with the file specified by fn and ft. The file must reside on a CMS-formatted minidisk accessed by CP.
LOGOVSM userid
sends new logo information to one or more VTAM service machines (VSM) specified by userid. userid is the user ID (or user ID pattern) of the VTAM service machine to which you want to send the new LOGO information. CP supports pattern matching as described in Usage Note 4.

Usage Notes

  1. If CP encounters errors while reading the specified logo configuration file, CP displays an error message on the terminal of the user who issued the REFRESH LOGOINFO command. If errors are found, CP ignores the REFRESH LOGOINFO command.
  2. Be careful when you change status area fields on a running system, because certain applications may depend on the status fields remaining constant.
  3. If the file you requested does not reside on a CP-accessed minidisk, CP does not delete the previous logo configuration information.
  4. Pattern matching follows these rules. Use an asterisk (*) to match any number of characters. Use a percent symbol (%) to match any single character.
  5. For more information on the contents of The Logo Configuration File, see z/VM®: CP Planning and Administration.
  6. For information on CP-accessed minidisks, see CPACCESS and QUERY CPDISKS.

Responses

Response 1:

If the command is successful, CP does not issue a response.

Response 2:

If you enter a REFRESH LOGOINFO command and there are errors in the specified logo configuration file, you see error messages. Each error message is preceded by another message that tells you where the error occurs in the file.

Response 3:

If you enter a REFRESH LOGOVSM command and the VTAM service machine you requested is not found, you receive message HCP6784E.

Messages

  • HCP002E Invalid operand - operand
  • HCP003E Invalid option - statement contains extra option(s) starting with option
  • HCP007E Invalid userid - userid
  • HCP6704E Missing token at end of line
  • HCP6706E Invalid {fn|ft} - fn|ft
  • HCP6737E Cannot find logo configuration file fn ft.
  • HCP6784E No VSMs logged on
  • HCP6784E No VSMs matching pattern userid logged on
  • HCP6784E VSM userid not logged on
  • HCP6787E No VSMs matching pattern userid_pattern support dynamic logo updates.
  • HCP6787E No VSMs support dynamic logo updates.
  • HCP6787E VSM userid does not support dynamic logo updates.