Unattended playback fails because no virtual terminals are available.

Knowledge Article

Article Number

000415993

Old Article Number

Article Type

Solutions to a Product Problem

Title

Unattended playback fails because no virtual terminals are available.

Summary

When an unattended playback executes as a batch job (PGM=EHSBATCH), it must run on a system which includes an active VTAM configuration required by the job. Therefore the job should include the correct system affinity in the JCL.

Product

BMC AMI DevX Performance Test for VTAM

Component

Applies to

Problem

Unattended playback failed because no virtual terminals were available.

In the example below, a job was read ($HASP100) on system SYS1, but executed on SYS2:

HH.MM.SS JOB##### $HASP373 JOBNAME STARTED - WLM INIT - SRVCLASS BATCH - SYS SYS2

The unattended playback was set to use terminal prefix EHPRX:

GROUP MSTR PORT MSTR EHSB016I READING INPUT CONTROL STATEMENTS
GROUP MSTR PORT MSTR EHSB023I INPUT STATEMENT :    CONTROL-
GROUP MSTR PORT MSTR EHSB023I INPUT STATEMENT :        PREFIX(EHPRX)-
GROUP MSTR PORT MSTR EHSB023I INPUT STATEMENT :        SUFFIX(3)-

But those terminals were not available on SYS2:

GROUP 0001 PORT 0001 EMTRM042 NO VIRTUAL TERMINALS ARE AVAILABLE
GROUP MSTR PORT MSTR EHSB098I MAXIMUM SCRIPT RC=0, INTERNAL RC=20

The job was rerun to capture a VTAM trace during the unattended playback of the GROUP which failed:

GROUP MSTR PORT MSTR EHSB023I INPUT STATEMENT :    GROUP CICS-
GROUP MSTR PORT MSTR EHSB023I INPUT STATEMENT :        TRACE(*) VTAMTRCE

The trace showed error x'005A' following the call to ETRMVTAM:

     PROGRAM LEVEL IDENTIFICATION
     002A 0007E285 0000 C5E3D9D4 E5E3C1D4 60D4D8D8 C6F1F7F0 |ETRMVTAM-MQQF170|
           0007E295 0010 4060D7F2 F9F8F6F1 F46040F0 F561F0F5 | -P298614- 05/05|
           0007E2A5 0020 61F2F340 F1F34BF4 F440              |/23 13.44       |
00000008 00 00AB8158 23.292 8:12:32.012 EHPRX001 CICS    .._..... ****** (00121)
     OPEN ACB FOR APPL: EHPRX001 RETURN CODE: 0008 ERROR:005A

Cause

The VTAM configuration was active and connectable on SYS1 but not on SYS2.

Solution

Issued the DISPLAY NET command to confirm where the VTAM application segment was active:

SYS1 23278 13:47:14.01
D NET,ID=APPLEHPR,E
IST097I DISPLAY ACCEPTED
IST075I NAME = APPLEHPR, TYPE = APPL SEGMENT
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV
IST360I APPLICATIONS:
IST080I EHPRX001 CONCT      EHPRX002 CONCT      EHPRX003 CONCT
IST080I EHPRX004 CONCT      EHPRX005 CONCT      EHPRX006 CONCT
IST080I EHPRX007 CONCT      EHPRX008 CONCT      EHPRX009 CONCT
IST080I EHPRX010 CONCT      EHPRX011 CONCT      EHPRX012 CONCT

Added system affinity to the job to ensure that it would execute on SYS1 where the VTAM application segment was active:

/*JOBPARM SYSAFF=SYS1

Attachment(s):