Before you can start the Customization Dialog, you must install
the WebSphere® Application
Server for z/OS® product
and make the product libraries available to the z/OS system on which the Customization
Dialog will run.
All product libraries should be cataloged. The Customization
Dialog does not use the product directory (/usr/lpp/zWebSphere/V6R1 by
default), but you must mount it and make it available before the Customization
Dialog's generated jobs can run.
You will need the ability to log on to TSO from a real or emulated 3270-type
terminal. Your logon display must support 3270 emulation and be set to a minimum
of 32 rows by 80 columns (32 x 80) in order for the ISPF Customization Dialog
to run.
- If your terminal has exactly 32 display rows, be sure the PF keys are
not shown. These can overlay Customization Dialog input fields. To hide the
PF keys, issue the PFSHOW OFF command in ISPF.
- If you have a 32-row display and use the ISPF split screen function, deselect "Always
show split line" on the ISPF Settings panel and split the screen at the
extreme top or bottom of the display. This prevents the split screen line
from displaying and lines in the Customization Dialog from being obscured.
Other uses of split screen will obscure lines in the Customization Dialog.
The following steps outline how to change your display size setting if
you use the IBM
® Personal
Communications Workstation program. Complete all the steps before you start
your TSO session.
- In the menu bar of the session window, select Communication.
- From the Communication window, select Configure.
- In the window that appears, press the Session Parameters button.
- Use the pull-down menu to select a screen-size setting between 32x80 and
62x160.
- Press the OK button until you are back at the session window.
You will need a TSO user ID that has READ access to the WebSphere Application
Server for z/OS product
libraries.
- After you have logged on with your user ID, you will see the ISPF menu
options. Select Settings, and under terminal characteristics find screen
format, and select max. This will maximize your screen for the
customization dialogs.
Starting the dialog: The BBOWSTRT command
To start
the Customization Dialog, log on to TSO and invoke the BBOWSTRT exec from
the SBBOCLIB product library using the following EXEC command.
Note: If you
enter the command from TSO Option 6, just type in the command. If you enter
the command on the ISPF command line, you must prefix it with "TSO".
EXEC
'was_hlq.SBBOCLIB(BBOWSTRT)' 'options'
where
the parameter:
- was_hlq
- is the data set name high-level qualifier for your WebSphere Application Server for z/OS product
libraries.
Note: The dialog libraries (SBBOCLIB, SBBOPxxx, SBBOMxxx, SBBOSLIB
and SBBOSLB2) must have the same data set name high-level qualifier in order
for the Customization Dialog to allocate the libraries correctly.
Be
sure to use the was_hlq value that corresponds to the level
of WebSphere Application
Server for z/OS product
code that you will use to run the resulting WebSphere Application Server for z/OS cells.
You can also specify the following options, separated by
spaces and surrounded in a single set of quotes:
- APPL(value)
- Specifies the application name you intend to use. This provides for separate
sets of Customization Dialog variables saved from one Customization Dialog
session to the next. The default value is BBO6. See Customization Dialog variables for details.
- LANG(value)
- Specifies the national language you want the Customization Dialog to use.
Specify "ENUS" for English or "JAPN" for Japanese. The default value is ENUS.
Note: Some
messages will still appear in English even if you specify another national
language, using the LANG option.
- PROD(list)
- Specifies a list of WebSphere Application Server for z/OS add-on products
that are also customized using the dialog. The list should consist of one
or more three-character product identifiers from the following table, separated
by spaces. If you do not want to customize any add-on products, omit the PROD option.
BBZ |
WebSphere Business
Integration |
- PRODHLQ(list)
- Specifies a list of high-level qualifiers for the WebSphere Application Server for z/OS add-on
products you specified with the PROD option. The list should
consist of one high-level qualifier for each entry in the PROD list, given
in the same order. If you do not want to customize any add-on products, omit
the PRODHLQ option.
If you are starting the dialog for the first time or using
a new
APPL value, you will first see a copyright screen.
Press ENTER to continue.
You should then see the Customization Dialog main
menu, similar to the following:
------------ WebSphere Application Server for z/OS Customization --------
Option ===> Appl: BBO6
Use this dialog to create WebSphere Application Server for z/OS
cells and nodes. Specify an option and press Enter.
1 Configure common MVS™ Groups and Users
2 Create stand-alone application server nodes. You must complete
Option 1 before starting this option.
3 Create Network Deployment cells and nodes. You must complete
Option 1 before starting this option.
4 Migrate a node.
5 License and Notices.
If you do not see the main menu, review
the steps and requirements above.