 |
The generic resource includes a GENERIC USERVAR
name, a generic mapping, and affinities. Only when all sessions have
been terminated for all real instances, all affinities are deleted,
and all real instances have performed CLOSE ACB processing, the generic
resource can be successfully deleted. This following examples show
how to delete a generic resource named neta.grappl, which has three
real instances.
ProcedurePerform the following steps to remove a generic
resource: - Identify all instances of the generic resource.
Issue DISPLAY NET,ID=grappl,IDTYPE=GENERIC at
every host in the sysplex. The following sample output is generated: d net,id=grappl,idtype=generic
IST097I DISPLAY ACCEPTED
IST075I NAME = GRAPPL, TYPE = GENERIC RESOURCE
IST1359I MEMBER NAME OWNING CP SELECTABLE APPC
IST1360I NETA.NETAPPL1 SSCP2A YES NO
IST1360I NETA.APPL1 SSCP1A NO NO
IST1360I NETA.APPLAA1 SSCPAA DEL NO
IST1393I GENERIC RESOURCE NAME RESOLUTION EXIT IS ISTEXCGR
IST314I END
This display shows three real instances,
each on a different VTAM®, associated
with the grappl generic resource. - The NETA.NETAPPL1 instance has issued an OPEN ACB and is selectable
as a generic resource from any host in the sysplex.
- The NETA.APPL1 instance has issued an OPEN ACB but SSCP1A does
not have CP-CP sessions with a network node server, and therefore,
NETA.APPL1 is not selectable from any host in the sysplex. However,
it is still registered as a generic resource and is selectable for
sessions that originate on SSCP1A.
- The NETA.APPLAA1 instance has either CLOSED its ACB, or remained
OPEN and issued the VTAM API
command to make itself not selectable.
- Terminate all sessions with all instances of the generic
resource.
Session information can be displayed using
the VTAM commands DISPLAY
SESSIONS,LU1=real_instance_name,SCOPE=ALL or DISPLAY NET,ID=real_instance_name,SCOPE=ALL.
Note: DISPLAY NET,ID=real_instance_name output indicates that the application is active (message
IST486I), its generic name (message IST1363I), and its session partners
(message IST635I).
d net,id=appl1,scope=all
IST097I DISPLAY ACCEPTED
IST075I NAME = NETA.APPL1, TYPE = APPL
IST486I STATUS= ACT/S, DESIRED STATE= ACTIV
IST1447I REGISTRATION TYPE = CDSERVR
IST1363I GENERIC RESOURCE NAME GRAPPL REPRESENTS NETA.APPL1
IST977I MDLTAB=***NA*** ASLTAB=***NA***
IST861I MODETAB=***NA*** USSTAB=***NA*** LOGTAB=***NA***
IST934I DLOGMOD=***NA*** USS LANGTAB=***NA***
IST1632I VPACING = 7
IST1938I APPC = NO
IST597I CAPABILITY-PLU ENABLED ,SLU ENABLED ,SESSION LIMIT NONE
IST231I APPL MAJOR NODE = APPL1A
IST654I I/O TRACE = OFF, BUFFER TRACE = OFF
IST1500I STATE TRACE = OFF
IST271I JOBNAME = ECHO, STEPNAME = ECHO, DSPNAME = IST3C391
IST228I ENCRYPTION = OPTIONAL , TYPE = DES
IST1563I CKEYNAME = APPL1 CKEY = PRIMARY CERTIFY = NO
IST1552I MAC = NONE MACTYPE = NONE
IST1050I MAXIMUM COMPRESSION LEVEL - INPUT = 0, OUTPUT = 0
IST1633I ASRCVLM = 1000000
IST1634I DATA SPACE USAGE: CURRENT = 0 MAXIMUM = 0
IST171I ACTIVE SESSIONS = 0000000001, SESSION REQUESTS = 0000000000
IST206I SESSIONS:
IST634I NAME STATUS SID SEND RECV VR TP NETID
IST635I LAA3270A ACTIV-S EAABEE18F0E34F0F 0002 0001 NETA
IST314I END
d net,id=netappl1,scope=all
IST097I DISPLAY ACCEPTED
IST075I NAME = NETA.NETAPPL1, TYPE = APPL
IST486I STATUS= ACT/S, DESIRED STATE= ACTIV
IST1447I REGISTRATION TYPE = CDSERVR
IST1363I GENERIC RESOURCE NAME GRAPPL REPRESENTS NETA.NETAPPL1
IST977I MDLTAB=***NA*** ASLTAB=***NA***
IST861I MODETAB=***NA*** USSTAB=***NA*** LOGTAB=***NA***
IST934I DLOGMOD=***NA*** USS LANGTAB=***NA***
IST1632I VPACING = 7
IST1938I APPC = NO
IST597I CAPABILITY-PLU ENABLED ,SLU ENABLED ,SESSION LIMIT NONE
IST231I APPL MAJOR NODE = APPL2A
IST654I I/O TRACE = OFF, BUFFER TRACE = OFF
IST1500I STATE TRACE = OFF
IST271I JOBNAME = ECHO, STEPNAME = ECHO, DSPNAME = IST36CF1
IST228I ENCRYPTION = OPTIONAL , TYPE = DES
IST1563I CKEYNAME = NETAPPL1 CKEY = PRIMARY CERTIFY = NO
IST1552I MAC = NONE MACTYPE = NONE
IST1050I MAXIMUM COMPRESSION LEVEL - INPUT = 0, OUTPUT = 0
IST1633I ASRCVLM = 1000000
IST1634I DATA SPACE USAGE: CURRENT = 0 MAXIMUM = 0
IST171I ACTIVE SESSIONS = 0000000002, SESSION REQUESTS = 0000000000
IST206I SESSIONS:
IST634I NAME STATUS SID SEND RECV VR TP NETID
IST635I L2A3270A ACTIV-S F6ABEEC3A58FC5CF 0001 0000 NETA
IST635I L1A3270A ACTIV-S EAABEEC3A28FC3B2 0001 0000 NETA
IST314I END
d net,id=applaa1,scope=all
IST097I DISPLAY ACCEPTED
IST075I NAME = NETA.APPLAA1, TYPE = APPL
IST486I STATUS= ACT/S, DESIRED STATE= ACTIV
IST1447I REGISTRATION TYPE = CDSERVR
IST1363I GENERIC RESOURCE NAME GRAPPL REPRESENTS NETA.APPLAA1
IST977I MDLTAB=***NA*** ASLTAB=***NA***
IST861I MODETAB=***NA*** USSTAB=***NA*** LOGTAB=***NA***
IST934I DLOGMOD=***NA*** USS LANGTAB=***NA***
IST1632I VPACING = 7
IST1938I APPC = NO
IST597I CAPABILITY-PLU ENABLED ,SLU ENABLED ,SESSION LIMIT NONE
IST231I APPL MAJOR NODE = APPLAA
IST212I ACBNAME = FIRSTONE
IST654I I/O TRACE = OFF, BUFFER TRACE = OFF
IST1500I STATE TRACE = OFF
IST271I JOBNAME = ECHO, STEPNAME = ECHO, DSPNAME = ISTC5DC7
IST228I ENCRYPTION = OPTIONAL , TYPE = DES
IST1563I CKEYNAME = APPLAA1 CKEY = PRIMARY CERTIFY = NO
IST1552I MAC = NONE MACTYPE = NONE
IST1050I MAXIMUM COMPRESSION LEVEL - INPUT = 0, OUTPUT = 0
IST1633I ASRCVLM = 1000000
IST1634I DATA SPACE USAGE: CURRENT = 0 MAXIMUM = 0
IST171I ACTIVE SESSIONS = 0000000001, SESSION REQUESTS = 0000000000
IST206I SESSIONS:
IST634I NAME STATUS SID SEND RECV VR TP NETID
IST635I LAA3270B ACTIV-S EAABEE18F0E34F11 0001 0000 NETA
IST314I END
The DISPLAY NET,SESSIONS command can also show the session partners (message IST874I).
d net,sessions,lu1=netappl1,scope=all,list=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SESSIONS
IST873I PLU SLU SID STATUS
IST874I NETA.NETAPPL1 NETA.L2A3270A F6ABEEC3A58FC5CF ACTIV
IST874I NETA.NETAPPL1 NETA.L1A3270A EAABEEC3A28FC3B2 ACTIV
IST924I -------------------------------------------------------------
IST878I NUMBER OF PENDING SESSIONS = 0
IST924I -------------------------------------------------------------
IST878I NUMBER OF ACTIVE SESSIONS = 2
IST924I -------------------------------------------------------------
IST878I NUMBER OF QUEUED SESSIONS = 0
IST924I -------------------------------------------------------------
IST878I NUMBER OF TOTAL SESSIONS = 2
IST314I END
- Delete all affinities associated with all real instances
of the generic resource.
Affinities associate a session
partner to a generic resource and a specific member of the generic
resource. They are created when the first session from a session partner
is started to a generic resource. As long as the affinity exists,
all subsequent sessions between the session partner and the generic
resource will be directed to the specific member maintained in the
affinity.
Affinities can be displayed using the DISPLAY
GRAFFIN,LU=*.*,GNAME=grappl command.
d net,graffin,lu=*.*,gname=grappl
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = GENERIC AFFINITY
IST1706I PARTNER NAME GENERIC RESOURCE MEMBER ATTRIBUTES
IST1707I NETA.LAA3270A NETA.GRAPPL APPL1 -VG--W--
IST1707I NETA.L1A3270A NETA.GRAPPL NETAPPL1 -VG--W--
IST1707I NETA.LAA3270B NETA.GRAPPL APPL1AA1 -AG6-W--
IST1454I 3 AFFINITIES DISPLAYED FOR LU=*.*
IST314I END
This display indicates the following about
the affinities associated with grappl: - The affinities for LAA3270A and L1A3270A are owned by VTAM (V).
- The affinity for LAA3270B is application owned (A) and persistent
(6).
- All affinities indicate the associated sessions were started using
the generic name (G).
- All affinities were created based on input from the MVS™ Workload manager (W).
All sessions between the session partner and the generic
resource member must end before any associated affinities can be deleted.
The different types of affinities would then be terminated using differing
rules: - An affinity that is VTAM owned is deleted when the last session between the session partner
and the generic resource ends.
- An affinity that is application owned and persistent can be deleted
only when the application notifies VTAM to delete the affinity. An affinity that is application
owned, but not persistent, is deleted if the application closes its
ACB or notifies VTAM to delete
the affinity. Deleting persistent or application-owned affinities
requires the application to be active and invocation of an application-unique
command, or application termination. See application-specific documentation
to determine how to delete application-owned and persistent affinities.
Sessions can be terminated by application users, application operator
commands, or the VTAM command VARY NET,TERM,LU1=real_instance_name.
v net,term,lu1=laa3270a
IST097I VARY ACCEPTED
IST457I POSITIVE TERM COMMAND RESPONSE
IST455I LU1=NETA.LAA3270A SESSIONS ENDED
The following
display shows that the VTAM-owned affinity for LAA3270A is deleted
after the session is terminated.
d net,graffin,lu=*.*,gname=grappl
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = GENERIC AFFINITY
IST1706I PARTNER NAME GENERIC RESOURCE MEMBER ATTRIBUTES
IST1707I NETA.L1A3270A NETA.GRAPPL NETAPPL1 -VG--W--
IST1707I NETA.LAA3270B NETA.GRAPPL APPL1AA1 -AG6-W--
IST1454I 2 AFFINITIES DISPLAYED FOR LU=*.*
IST314I END
- Close the VTAM ACB
for every real instance of the generic resource.
In
some cases, VTAM retains information
about the generic resource capability of the application as long as
the application exists, so the application must perform CLOSE ACB
processing. The CLOSE ACB can be triggered by an application-unique
command or the VTAM command VARY INACT,ID=real_instance_name can be used.
v net,inact,id=applaa1
IST097I VARY ACCEPTED
IST105I APPLAA1 NODE NOW INACTIVE
The command DISPLAY ID=real_instance_name can be used to verify
that every instance of the generic resource has closed its ACB. This
command needs to be issued at the owning host of each real instance
to verify that the CLOSE ACB has been performed.
d net,id=applaa1
IST097I DISPLAY ACCEPTED
IST075I NAME = NETA.APPLAA1, TYPE = APPL
IST486I STATUS= INACT, DESIRED STATE= INACT
IST1447I REGISTRATION TYPE = CDSERVR
IST977I MDLTAB=***NA*** ASLTAB=***NA***
IST861I MODETAB=***NA*** USSTAB=***NA*** LOGTAB=***NA***
IST934I DLOGMOD=***NA*** USS LANGTAB=***NA***
IST1632I VPACING = 7
IST1938I APPC = NO
IST597I CAPABILITY-PLU INHIBITED,SLU INHIBITED,SESSION LIMIT NONE
IST231I APPL MAJOR NODE = APPLAA
IST212I ACBNAME = FIRSTONE
IST654I I/O TRACE = OFF, BUFFER TRACE = OFF
IST1500I STATE TRACE = OFF
IST271I JOBNAME = ***NA***, STEPNAME = ***NA***, DSPNAME = ***NA***
IST228I ENCRYPTION = OPTIONAL , TYPE = DES
IST1563I CKEYNAME = APPLAA1 CKEY = PRIMARY CERTIFY = NO
IST1552I MAC = NONE MACTYPE = NONE
IST1050I MAXIMUM COMPRESSION LEVEL - INPUT = 0, OUTPUT = 0
IST1633I ASRCVLM = 1000000
IST1634I DATA SPACE USAGE: CURRENT = ***NA*** MAXIMUM = ***NA***
IST171I ACTIVE SESSIONS = 0000000000, SESSION REQUESTS = 0000000000
IST314I END
Note: Message IST486I indicates
that the application is inactive.
- Identify all hosts in the sysplex that contain a GENERIC
USERVAR.
GENERIC USERVAR mappings can exist on a VTAM because a generic name was
once resolved on this host. To identify whether a GENERIC USERVAR
exists, issue DISPLAY RSCLIST,ID=grappl,IDTYPE=GENERIC on every host in the sysplex.
d net,rsclist,id=grappl,idtype=generic
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = RSCLIST
IST1417I NETID NAME STATUS TYPE MAJNODE
IST1418I NETA GRAPPL ACTIV GENERIC RESOURCE **NA**
IST1418I NETA GRAPPL *NA* GENERIC USERVAR **NA**
IST314I END
This display indicates that the resource
name GRAPPL with resource type GENERIC RESOURCE exists in the generic
resource coupling facility structure. It also indicates that this VTAM has defined a type GENERIC
USERVAR for GRAPPL.
- Delete the generic resource information from the sysplex.
When all sessions have been terminated for all real instances,
all affinities are deleted, and all real instances have performed
CLOSE ACB processing, the generic resource grappl can be successfully
deleted. Issue the command MODIFY GR,OPTION=DELETE,GNAME=netid.grappl at every host in the sysplex that has a GENERIC USERVAR for the
generic resource. This should include every host where a real instance
resided, but could also include other hosts in the sysplex.
All members of the generic resource are not selectable.
d net,id=grappl
IST097I DISPLAY ACCEPTED
IST075I NAME = GRAPPL, TYPE = GENERIC RESOURCE
IST1359I MEMBER NAME OWNING CP SELECTABLE APPC
IST1360I NETA.APPL1 SSCP1A DEL NO
IST1360I NETA.NETAPPL1 SSCP2A DEL NO
IST1360I NETA.APPLAA1 SSCPAA DEL NO
IST1393I GENERIC RESOURCE NAME RESOLUTION EXIT IS ISTEXCGR
IST314I END
All affinities have been deleted.
d net,graffin,lu=*.*,gname=grappl
JOB 2 IST097I DISPLAY ACCEPTED
JOB 2 IST350I DISPLAY TYPE = GENERIC AFFINITY
IST1358I NO QUALIFYING MATCHES
IST1454I 0 AFFINITIES DISPLAYED
IST314I END
The command to delete the generic resource
must be issued at every host in the sysplex that has a GENERIC USERVAR
for the generic resource.
modify vtam,gr,gname=neta.grappl,option=delete
IST097I MODIFY ACCEPTED
IST223I MODIFY GR COMMAND COMPLETED
If a MODIFY GR,DELETE command is issued at a host that has temporarily
lost connectivity to the generic resource coupling facility structure,
then generic resource data local to the host can still be deleted.
However the MODIFY GR DELETE command must complete
successfully from at least one host connected to the generic resource
coupling facility structure in order to delete the generic resource
data in the structure.
When the generic resource name has
been deleted, another resource such as an application or USERVAR can
be defined with the same name. For instance, the MODIFY USERVAR command can be used to create a USERVAR for the name grappl.
modify vtam,uservar,id=grappl,option=update,value=appl1
IST097I MODIFY ACCEPTED
IST825I USERVAR DEFINED - NAME = GRAPPL, VALUE = APPL1
IST314I END
d net,id=grappl
IST097I DISPLAY ACCEPTED
IST075I NAME = APPL1, TYPE = APPL
IST113I GRAPPL IS A USERVAR WITH VALUE APPL1 IN NETWORK NETA
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV
IST1447I REGISTRATION TYPE = CDSERVR
IST599I REAL NAME = NETA.APPL1
IST977I MDLTAB=***NA*** ASLTAB=***NA***
IST861I MODETAB=***NA*** USSTAB=***NA*** LOGTAB=***NA***
IST934I DLOGMOD=***NA*** USS LANGTAB=***NA***
IST1632I VPACING = 7
IST1938I APPC = NO
IST597I CAPABILITY-PLU ENABLED ,SLU ENABLED ,SESSION LIMIT NONE
IST231I APPL MAJOR NODE = APPL1A
IST654I I/O TRACE = OFF, BUFFER TRACE = OFF
IST1500I STATE TRACE = OFF
IST271I JOBNAME = ECHO, STEPNAME = ECHO, DSPNAME = ISTB972A
IST228I ENCRYPTION = OPTIONAL , TYPE = DES
IST1563I CKEYNAME = APPL1 CKEY = PRIMARY CERTIFY = NO
IST1552I MAC = NONE MACTYPE = NONE
IST1050I MAXIMUM COMPRESSION LEVEL - INPUT = 0, OUTPUT = 0
IST1633I ASRCVLM = 1000000
IST1634I DATA SPACE USAGE: CURRENT = 0 MAXIMUM = 0
IST171I ACTIVE SESSIONS = 0000000000, SESSION REQUESTS = 0000000000
IST314I END
Note: Message IST113I indicates
that GRAPPL is a USERVAR for APPL1.
In general, you should
use generic resources because they have a greater degree of availability
and workload distribution. However, if you use the MODIFY GR,DELETE
command to consolidate a group of generic resource applications to
a single application represented by a USERVAR, then caution should
be taken to ensure that the single USERVAR application can handle
the consolidated workload.
|
z/OS Communications Server: SNA Network Implementation Guide
Copyright IBM Corporation 1990, 2014