Defining the VTAM EQAMVnnn APPL definition statements

You must define the APPL definition statements that z/OS® Debugger uses for its end of the VTAM® session with the terminal LU. You can define up to 999 APPLs for z/OS Debugger. You can define an APPL by using one of the following naming conventions:

• Define each APPL with the following naming convention: the first five characters of the APPL name must be EQAMV and the last three characters must be consecutive three digit numbers, starting with 001. Do not code an ACBNAME operand on the APPL definition statements for this method.
• Define each APPL name with the naming convention you use at your site. Code an ACBNAME operand on the APPL definition statement that uses EQAMV as the first five characters, and three numeric digits (starting with 001) as the last three characters.

The number of APPL names you define must be sufficient to allow for the maximum number of concurrent z/OS Debugger full-screen mode using the Terminal Interface Manager sessions. (z/OS Debugger uses one of these APPL names for its end of each VTAM session that is initiated with a terminal LU.)

The descriptions and examples used in this book assume you defined APPL names by using the EQAMVnnn naming convention. z/OS Debugger uses the EQAMVnnn names for internal processing.

The EQAWAPPL member in the hlq.SEQASAMP data set predefines 50 APPL names, EQAMV001 to EQAMV050. You can do one of the following tasks to add this member to the VTAM definitions library (VTAMLST).

• Copy EQAWAPPL into a new member:
  1. Create a new member in the VTAM definitions library (VTAMLST). The VTAM definitions library is often stored in the data set SYS1.VTAMLST.
  2. Copy the contents of the EQAWAPPL member into the new member.
  3. Add the new member's name to the VTAM start options configuration file, ATCCONxx, so that VTAM activates the z/OS Debugger APPL definitions at initialization.
• Copy EQAWAPPL into an existing member that is already defined in VTAMLST:
  1. Select a member in the VTAM definitions library (VTAMLST) that contains the major node definitions.
  2. Copy the APPL definition statements for z/OS Debugger from the EQAWAPPL member into the selected member.
     Tip: The existing member has the VBUILD TYPE=APPL statement, so do not copy this statement from EQAWAPPL.

If you are running VTAM in a multi-domain environment and you require the ability to debug full-screen mode using the Terminal Interface Manager on more than one host, edit the copy of EQAWAPPL on each system to make the names for z/OS Debugger major and minor nodes unique for each system.

For example, if you have hosts SYSA, SYSB, and SYSC, and need to provide definitions for up to 50 concurrent users debugging programs in full-screen mode using the Terminal Interface Manager on each system, you can code the following entries:

• SYSA VTAMLST EQAWAPPL entry:

  EQAAPPLA VBUILD TYPE=APPL
  EQAMV001 APPL  AUTH=(PASS,ACQ),PARSESS=NO
  EQAMV002 APPL  AUTH=(PASS,ACQ),PARSESS=NO
  ...
  EQAMV050 APPL  AUTH=(PASS,ACQ),PARSESS=NO

• SYSB VTAMLST EQAWAPPL entry:

  EQAAPPLB VBUILD TYPE=APPL
  EQAMV051 APPL  AUTH=(PASS,ACQ),PARSESS=NO
  EQAMV052 APPL  AUTH=(PASS,ACQ),PARSESS=NO
  ...
  EQAMV100 APPL  AUTH=(PASS,ACQ),PARSESS=NO

• SYSC VTAMLST EQAWAPPL entry:

  EQAAPPLC VBUILD TYPE=APPL
  EQAMV101 APPL  AUTH=(PASS,ACQ),PARSESS=NO
  EQAMV102 APPL  AUTH=(PASS,ACQ),PARSESS=NO
  ...
  EQAMV150 APPL  AUTH=(PASS,ACQ),PARSESS=NO

You can have up to 999 unique APPL names for full-screen mode using the Terminal Interface Manager spread across your network. For an example on how to configure many APPL names in a network with multiple LPARs, see Example: Defining the VTAM EQAMVnnn and Terminal Interface Manager APPL definition statements when z/OS Debugger runs on four LPARs.

As an alternative to coding each minor node name, you can use the Model Application Names function. With this function, VTAM dynamically creates the minor nodes. Use one of the following ways (alter these examples, if needed, to maintain unique names per system as discussed in Defining the VTAM EQAMVnnn APPL definition statements):

• EQAMV??? APPL AUTH=(PASS,ACQ),PARSESS=NO

• ABCDE??? APPL AUTH=(PASS,ACQ),PARSESS=NO,ACBNAME=EQAMV???