![[z/OS]](ngzos.gif)
Set up the operations and control panels
To set up the operations and control panels you must first set up the libraries that contain the required panels, EXECs, messages, and tables. To do this, you must take into account which national language feature is to be used for the panels. When you have done this, you can optionally update the main ISPF menu for IBM® MQ operations and control panels and change the function key settings.
- You need to perform this task once for each z/OS® system where you want to run IBM MQ.
- You might need to perform this task when migrating from a previous version.
Setting up the libraries
- Ensure that all the libraries contained in your concatenations are either in the same format (F, FB, V, VB) and have the same block size, or are in order of decreasing block sizes. Otherwise, you might have problems trying to use these panels.
-
Include the library thlqual.SCSQEXEC in your SYSEXEC or
SYSPROC concatenation or activate it using the TSO ALTLIB command. This library, which is allocated
with a fixed-block 80 record format during installation, contains the required EXECs.
It is preferable to put the library into your SYSEXEC concatenation. However, if you want to put it in SYSPROC, the library must have a record length of 80 bytes.
- Add thlqual.SCSQAUTH and thlqual.SCSQANLx to the TSO logon procedure STEPLIB or activate it using the TSO TSOLIB command, if it is not in the link list or the LPA.
-
You can either add the
IBM MQ panel libraries permanently to your ISPF library
setup, or allow them to be set up dynamically when the panels are used. For the former choice, you
need to do the following:
- Include the library containing the operations and control panel definitions in your ISPPLIB concatenation. The name is thlqual.SCSQPNLx, where x is the language letter for your national language.
- Include the library containing the required tables in your ISPTLIB concatenation. The name is thlqual.SCSQTBLx, where x is the language letter for your national language.
- Include the library containing the required messages in your ISPMLIB concatenation. The name is thlqual.SCSQMSGx, where x is the language letter for your national language.
- Include the library containing the required load modules in your ISPLLIB concatenation. The name of this library is thlqual.SCSQAUTH.
For the latter choice, use the z/OS LIBDEF command. See Examples for a link to various keywords you can use.
- Test that you can access the IBM MQ
panels from the TSO Command Processor panel. This is usually option 6 on the ISPF/PDF Primary
Options Menu. The name of the EXEC that you run is CSQOREXX. There
are no parameters to specify if you have put the IBM MQ
libraries permanently in your ISPF setup as in step 4. If
you have not, use the following:
CSQOREXX thlqual langletter
wherelangletter
is a letter identifying the national language to be used:- C
- Simplified Chinese
- E
- U.S. English (mixed case)
- F
- French
- K
- Japanese
- U
- U.S. English (uppercase)
Updating the ISPF menu
CMD(%CSQOREXX thlqual langletter)
For information about thlqual
and langletter
, see Step 5.
For more details, see the z/OS: ISPF Dialog Developer's Guide and Reference manual.
Updating the function keys and command settings
You can use the normal ISPF procedures for changing the function keys and command settings used by the panels. The application identifier is CSQO.
However, this is not recommended because the help information is not updated to reflect any changes that you have made.