Installing the z/VM system operator console facility to collect operator messages on the guest user console
Before you begin
Before uploading the installation material to the z/VM system, make sure that the following utilities are installed:
VMARC
To obtain the VMARC package and installation instructions, go to www.vm.ibm.com/download/.- REXX package or runtime library
You can use the IBM REXX library product or the free IBM REXX Alternate Library.
To install the system operator console facility to collect operator messages on the guest user console
- Download the installation material to your workstation.
Upload the material to the z/VM system.
The following example illustrates how to use FTP to send the material to the MAINT 191 minidisk:
The following sample is a sample FTP session initiated from a Microsoft Windows command prompt to the virtual machine. The fields marked with <---ENTER are mandatory.
----------------------------------------------------------------
C:\CORREL>FTP 10.100.0.235 <-------------------------------ENTER
Connected to 10.100.0.235
220-FTPSERV IBM VM Level 630 at Z63PRD01, 10:50:26 EDT MONDAY 2017-05-16
220 Connect will close it idle for more than 5 minutes
User (10.100.0.235:(none)): maint/by/username <----------ENTER
331 Send passwords please.
Password: <------------------------------------------ENTER
230 MAINT logged in: working directory = MAINT 191
ftp> bin <-----------------------------------------------ENTER
200 Representaion type IMAGE.
ftp> quote site fix 80 <----------------------------------ENTER
200 Site command was accepted.
ftp> put vmconsol.vmarc <---------------------------------ENTER
200 Port request OK.
150 Storing file 'vmconsol.vmarc'
250 Transter completed successfully
ftp: 11920 bytes sent in 0.12Seconds 102.76bytes/sec
ftp> quit <-----------------------------------------------ENTER
Quit command received. Goodbye.
----------------------------------------------------------------- Shut down the primary system operator's virtual machine by running the FORCE OPERATOR command.
- Shut down the guest user's virtual machine by running the FORCE guestUserID command.
- Load the materials onto the guestUserID 0191 minidisk by using the CZAVvrmm.VMCONSOL.VMARC file.
- Perform one of the following steps:
If the OPERATOR user ID is already set up on this system, run the following commands. The fields marked with <---ENTER are mandatory.
----------------------------------------------------------------
link operator 191 1 mr <-------------------------------ENTER
Ready; t=0.01/0.01 12:25:48
access 1 c <-------------------------------------------ENTER
Ready; t=0.01/0.01 12:25:58
copyfile profile exec c = exec-bk = (olddate <---------ENTER
Ready; t=0.01/0.01 12:26:10
----------------------------------------------------------------To make sure that the product does not call the OPERATOR EXEC file, use the XEDIT command to remove the 'EXEC 'userid() statement from the PROFILE EXEC file.
To send operator messages to the guest user's console, use the command to add the 'CP SET OBSERVER guestUserID' statement to the PROFILE EXEC file.
If OPERATOR user ID is not already set up on the system, run the following commands. The fields marked with <---ENTER are mandatory.
----------------------------------------------------------------
link operator 191 1 mr <-------------------------------ENTER
Ready; t=0.01/0.01 12:25:48
access 1 c <-------------------------------------------ENTER
Ready; t=0.01/0.01 12:25:58
copyfile profile exec c = exec-ibm = (olddate <--------ENTER
Ready; t=0.01/0.01 12:26:10
----------------------------------------------------------------To send operator messages to the guest user's console, use the command to add the 'CP SET OBSERVER guestUserID' statement to the PROFILE EXEC file.
- Perform one of the following steps:
If the guest user ID is already set up on this system, run the following commands. The fields marked with <---ENTER are mandatory.
----------------------------------------------------------------
link <guestUserID> 191 1 mr <-------------------------------ENTER
Ready; t=0.01/0.01 12:25:48
access 1 c <-------------------------------------------ENTER
Ready; t=0.01/0.01 12:25:58
copyfile profile exec c = exec-ibm = (olddate <--------ENTER
Ready; t=0.01/0.01 12:26:10
vmarc unpk vmconsol vmarc a = = c ( replace <----------ENTER
PROFILE EXEC C1. Bytes in= 122, bytes out= 323 ( 200%)
OPERATOR SPARMS C1. Bytes in= 160, bytes out= 453 ( 282%)
OPERATOR EXEC C1. Bytes in= 9160, bytes out= 453 ( 283%)
CZAUME TEXT C1. Bytes in= 2400, bytes out= 3600 ( 150%)
Ready; t=0.01/0.01 12:26:37
----------------------------------------------------------------If the guest user ID is not already set up on the system, run the following commands. The fields marked with <---ENTER are mandatory.
----------------------------------------------------------------
link <guestUserID> 191 1 mr <----------------------------ENTER
Ready; t=0.01/0.01 12:25:48
access 1 c <----------------------------------------ENTER
Ready; t=0.01/0.01 12:25:58
vmarc unpk vmconsol vmarc a = = c <-----------------ENTER
PROFILE EXEC C1. Bytes in= 122, bytes out= 323 ( 200%)
OPERATOR SPARMS C1. Bytes in= 160, bytes out= 453 ( 282%)
OPERATOR EXEC C1. Bytes in= 9160, bytes out= 453 ( 283%)
CZAUME TEXT C1. Bytes in= 2400, bytes out= 3600 ( 150%)
Ready; t=0.01/0.01 12:26:37
-----------------------------------------------------------------
Copy the sample EXEC and parameter file as shown in the following example:
copyfile OPERATOR EXEC c <guestUserID> EXEC c
Ready; t=0.01/0.01 12:28:17
copyfile operator sparms c = <guestUserID> parms c
Ready; t=0.01/0.01 12:29:09Add the following statements to the guest user's server parameter file, guestUserID PARMS, by using the XEDIT command:
Statement
Value
server_ip
IP address in dotted decimal notation
server_port
Port number greater than 1024
The following statements are optional:
Statement
Value
auth_user
Users who are authorized to issue the SETTIMER and STOP commands to the Datastream for z/VM agent. For more information about the SETTIMER and STOP commands, see Command and syntax reference.
The default value is maint.
tcpserv
ID of the TCP/IP server.
The default value is tcpip.
wait_time
Time to wait, in seconds, between RACF SMF SWITCH commands
The value must be a whole number from 1 through 3600.
The default value is 30 seconds.
If you enter an invalid value, the default value is used.
*
Comment
The values for server_ip and server_port statements must match the IP address and port number that are defined in the $$$VMCON member of the BMC AMI Datastream for z/OS agent parameter data set.
Release and detach the C disk by using a release c (detach command.
Start the OPERATOR user ID by running an xautolog operator ipl cms command.
Start the guest user ID by running an xautolog guestUserID ipl cms command.