nonqueriablehaose100

IBMCL/SuperSessionforz/OSCustomizationGuideVersion2Release1SC27-4584-00NoteBeforeusingthisinformationandtheproductitsupports,besuretoreadthegeneralinformationunder"Notices"onpage189.
SecondEdition(December2015)ThiseditionappliestoVersion2Release1ofIBMCL/SuperSessionforz/OS(programnumber5601-B28)andtoallsubsequentreleasesandmodificationsuntilotherwiseindicatedinneweditions.
OrderpublicationsthroughyourIBMrepresentativeortheIBMbranchofficeservingyourlocality.
IBMwelcomesyourcomments.
Forinformationonhowtosendcomments,see"HowtosendyourcommentstoIBM"onpagevii.
CopyrightIBMCorporation1997,2015.
USGovernmentUsersRestrictedRights–Use,duplicationordisclosurerestrictedbyGSAADPScheduleContractwithIBMCorp.
ContentsReadThisFirstviiPrefaceviiAboutthisdocumentviiAccessibilityviiHowtosendyourcommentstoIBMviiDocumentationConventionsviiiIntroductionviiiPanelsandfiguresviiiRevisionbarsviiiVariablesandliteralsviiiSymbolsviiiChapter1.
OptionsforSettingUpYourNetwork.
1NetworkEntryPoints1HowTerminalsConnecttoCL/SuperSession.
.
.
1VTAMLOGAPPL.
1FORWARDCommandwiththeVTAMLOGAPPL2SIMLOGONfromCLSDSTPASSApplications.
.
2VTAMResourceDefinitionsforCL/SuperSession.
.
3SpecifyinganEntryPointforLU1Devices.
.
.
3VTAMAuthorizedPath.
7WheretoFindtheACBNamesintheProductLibraries.
8CL/SuperSessionStartedTaskJCLandRuntimeDatasets8Chapter2.
VirtualTerminals.
13OtherAPPLParameters16PARSESSParameter16AUTHParameter16EASParameter17MODETABParameter17DLOGMODParameter17SRBEXITParameter18SESSLIMParameter18Chapter3.
VirtualTerminalPools.
.
.
19SelectingPredefinedPools19DefiningaNewVirtualTerminalPool20DefiningtheLogmodeTableEntry22ApplicationsthatSetTheirOwnSessionParameters22SelectingaLogmodeEntryforExtendedFunctions23SelectingaLogmodeEntryDynamically.
.
.
.
23UnspecifiedScreenSizeBind23ExplicitPartitionOperation24VirtualTerminalSharing24TSOConsiderations25CICSConsiderations25CICSwithoutAutoinstall25CICSwithAutoinstall27HowVirtualTerminalsAreSelectedfromVirtualTerminalPools28SelectingaVirtualTerminalPoolDynamically.
.
.
28AssigningSpecificVirtualTerminalswithinaPool29MappingVirtualTerminals29DefiningVirtualTerminalsDynamically30DeletingorRedefiningaVirtualTerminalPoolDefinition31DisplayingVirtualTerminalInformation.
32Chapter4.
VirtualPrinters33VirtualPrinterSharing.
33UsingVirtualPrinters33UsingVPRINTERwhenPrintingSessionScreens.
.
34UsingVirtualPrintersinPortContentionEnvironments.
35Chapter5.
CL/SuperSessionCustomization39SettingCL/SuperSessionInitializationParameters40DefiningaNetworkEntryPoint40GatewayConfiguration41DataElements44DataSources47ResolutionSequence53CustomizingMessages54DefiningApplications57APPLDEF57SpecifyingMorethanOneAPPLDEFperApplication62ChangingApplicationDefinitionsDynamically62UsingApplicationDefinitionHelp.
63ApplicationDefinitionExamples63CreatingAuthorizedApplicationLists66APPLISTCommand66CustomizingtheNetworkBroadcastFacility.
.
67CreatingaBroadcastGroup68CustomizingtheNewsFacility69Chapter6.
AdditionalCustomizationforIMS71CustomizingCL/SuperSessionSupportforIMS.
.
71DefiningtheControlSession.
71DefiningSelections72AssigningLogicalTerminalstoUsers.
72CL/SuperSessionSupportforIMSSessionServices73SessionCleanup74LogicalTerminalAssignment74SessionServiceImplementation.
74VTAMRequirements75IMSRequirements75CL/SuperSessionSupportforIMSRequirements76DefininganIMS/DCSubsystem76SessionCleanup77DEQUEUEVirtualMTOCommandSequence.
.
77LTERMAssignment78ASSIGNVirtualMTOCommandSequence.
.
.
79CopyrightIBMCorp.
1997,2015iiiCombiningSessionCleanupandLogicalTerminalAssignment80Chapter7.
AdditionalCustomizationforCL/SuperSession81CustomizingTriggers81WindowControlTriggerDialogs82FileTransferTrigger83VectorGraphics83IDMSOnlineMapping83ImplicitPartitionsQueryReply.
83TerminalCompatibility84OutboundCompression84InboundCompression85InvalidCodePointTranslation86Chapter8.
ProductDialogCustomization87IntroductiontoDialogs87UnderstandingaDialog88ContinuationCharacters89ModifyingaDisplay90ChangingtheColorandOtherAttributes.
.
.
90ChangingtheFormatofaTable91ModifyingPF1292DisconnectingaLockedTerminal92AutomatingApplicationLogon.
93ControlDialog93CustomizingVariables.
94ImplementingaDialog94Chapter9.
CT/EngineCustomization.
.
95DefiningtheCT/EngineOperatorFacility.
.
.
.
95CT/EngineOperatorFacilitySignonPanel.
.
.
.
96DefiningaNetworkEntryPointwiththeDIALOGCommand96DialogManagerOptionsinKLVINDM96PRELOAD.
96PresentationSpaceManagerInitializationParametersinKLVINPSM97GlobalSenseTableSupportinKLVINSNS.
.
.
.
97SenseRuleDefinitionStatement97DefiningtheTableDatabaseinKLVINTB.
.
.
.
100VIEWLOGDatabaseAllocationandInitializationParametersinKLVINVLG101VTAMProgramOperator(VPO)InitializationParametersinKLVINVPO102VirtualSessionManagerInitializationParametersinKLVINVSM103CLSDST-PASSEstablishmentTimeout.
.
.
.
103VTAMOptionsInitializationParametersinKLVINVTM103Chapter10.
NetworkAccessManager105ConfiguringtheNetworkAccessManager.
.
.
.
105DefiningNAMControlPoints106DefiningNAMProcessingOptions109KLVINNAMExamples110ProtectedClassLists111MaintainingtheNAMDatabase112PrintingtheNAMDatabase113RACFandSAFConsiderations113SecuringCT/EngineApplicationswithRACF113RACFSecuredSignonSupport114ControlPointUserExitRoutines117Conventions117RegistersonEntry118RegistersonExit118$NAMUEPLParameterList118ExitReturnCodes120FieldValidationUserExitRoutines121Conventions.
121RegistersonEntry.
121RegistersonExit122$NAMFEPLParameterList.
122ExitReturnCodes123ExtendedUserAuthenticationSupport123Installation124Implementation124LogonInheritanceSupport124RuleListInterpretSupport126ImplementingGroupProfileswithACF2.
.
.
126ValidatingOnlytheACF2UserID127Chapter11.
NetworkAccountingFacility129NAFStartupParameters129$NAFRMacro130NAFRecordTypes130CL/SuperSessionRecordTypes130NAFReporting.
132NAFRecordLayouts132STARTUPRecord133SHUTDOWNRecord134EntryValidationRecord134(VSSULGN)CL/SuperSessionUserLogon.
.
.
135(VSSULGF)CL/SuperSessionUserLogoff.
.
.
.
135(VSSTLGN)CL/SuperSessionVirtualTerminalLogon136(VSSTLGF)CL/SuperSessionVirtualTerminalLogoff136(GWLIMIT)CL/SuperSessionRecord137(GWLOGON)CL/SuperSessionLogon138(GWLOGOFF)CL/SuperSessionLogoff.
.
.
.
138(GWPTSTRT)CL/SuperSessionSINGLEStart.
.
138(GWPTSTOP)CL/SuperSessionSINGLEStop.
.
139Chapter12.
CL/SuperSessionStartupParameters141LocatingParameterstoOverride141CalculatingMINIMUM141UsingQUIESCE142CL/SuperSessionStartupParameters142AMODE31143APF143CONFIRM143CONSECHO143DATEFMT144DEBUG144INBDLIM144ivIBMCL/SuperSessionforz/OSCustomizationGuideINBOUND144INITIAL145INITLIST145INTLCHAR146LIMIT146LOGBLOCK.
146LOGBUFS146LSRPOOL146LSRSTRNO147MAXIMUM147MINIMUM148OPLIMIT149OPLOCAL149OPMASK.
149OPSTART149OUTBDLIM149OUTBOUND150PACK150QUIESCE.
150RESERVE.
151SDUMP152STGMON153SWAP153TASKS153TRACE153UPPERDLG154UPPERLOG154UPPERWTO.
154WTO154WTODC154WTORC155Chapter13.
ResponseTimeMonitorInterface157ETE(NetSpy)RecommendedInstallationProcedure157MappingMessageFormat158Activatingtheinterface158MonitoringOtherApplicationswithNetSpy.
.
160Chapter14.
Storage163StorageAllocation163MonitoringStorage163ExtendedStorage163StoragePreallocation164Chapter15.
TablesUnload/LoadFacility167TablesUnload/LoadUtilityDialog167InvokingKLVTBULD.
167UNLOADExample170LOADExample170UserDialog171UnloadedDataStructure172Chapter16.
PerformanceTips.
.
.
.
175OverallPerformanceConsiderations.
175Multiple-ProcessorCPUs175CPUConsumption175CSAandECSAAllocation175APFAuthorization176SRBExits.
176DispatchingPriority176ApplicationStatusMonitoring.
176Compression176DataCompressionforDialogPanels.
177AddingTriggers177AppendixA.
BringingUpaTestSystem179AppendixB.
CL/ENGINEProductLibrariesReference.
181TLVSYSIN181TLVPARM182TLVCMDS185TLVPNLS187TLVLOAD187Notices189Trademarks190Index191ContentsvviIBMCL/SuperSessionforz/OSCustomizationGuideReadThisFirstPrefaceAboutthisdocumentThismanualprovidesinstructionsandexplanationsforcustomizingCL/SuperSessionforyournetwork,system,andusers.
Beforeusingthismanual,besureyouhavecompletedallstepsinthefollowingdocuments:vProgramDirectoryvBasicConfigurationGuideAccessibilityAccessibilityfeatureshelpauserwhohasaphysicaldisability,suchasrestrictedmobilityorlimitedvision,tousesoftwareproductssuccessfully.
ThemajoraccessibilityfeaturesinCL/SuperSessionenableusersto:vUseassistivetechnologiessuchasscreenreadersandscreenmagnifiersoftware.
Consulttheassistivetechnologydocumentationforspecificinformationwhenusingittoaccessz/OSinterfaces.
vCustomizedisplayattributessuchascolor,contrast,andfontsize.
vOperatespecificorequivalentfeaturesusingonlythekeyboard.
YoucanperformmosttasksrequiredtosetupandrunCL/SuperSessionusinga3270emulatorloggedontoTSO.
IBMPersonalCommunicationsforWindowsprovides3270emulationwithaccessibilityfeaturesforpeoplewithdisabilities.
Youcanusethisproducttoprovidetheaccessibilityfeaturesyouneed.
HowtosendyourcommentstoIBMYourfeedbackisimportantinhelpingustoprovideaccurate,high-qualityinformation.
IfyouhavecommentsaboutthisinformationoranyotherIBMCL/SuperSessionforz/OSdocumentation,contactusinoneoftheseways:vUsetheOnlineReaders'CommentsFormatwww.
ibm.
com/software/awdtools/rcf/.
vSendyourcommentstothefollowingaddress:comments@us.
ibm.
com.
Besuretoincludethenameofthedocument,thepublicationnumber,theversionofIBMCL/SuperSessionforz/OS,and,ifapplicable,thespecificlocation(forexample,thepagenumberorsectionheading)ofthetextthatyouarecommentingon.
WhenyousendinformationtoIBM,yougrantIBManonexclusiverighttouseordistributetheinformationinanywaythatIBMbelievesappropriatewithoutincurringanyobligationtoyou.
CopyrightIBMCorp.
1997,2015viiDocumentationConventionsIntroductionThefollowingtypographicalconventionsareusedforcommandsyntaxinthisdocumentation.
PanelsandfiguresThepanelsandfiguresinthisdocumentarerepresentations.
Actualproductpanelsmaydiffer.
RevisionbarsRevisionbars(|)mayappearintheleftmargintoidentifyneworupdatedmaterial.
VariablesandliteralsInexamplesofcommandsyntax,uppercaselettersareactualvalues(literals)thattheusershouldtype;lowercaselettersareusedforvariablesthatrepresentdatasuppliedbytheuser.
Defaultvaluesareunderscored.
LOGONAPPLID(cccccccc)Intheaboveexample,youtypeLOGONAPPLIDfollowedbyanapplicationidentifier(representedbycccccccc)withinparentheses.
Theapplicationidentifiercanhaveatmosteightcharacters.
Note:Inordinarytext,variablenamesappearinitalics.
SymbolsThefollowingsymbolsmayappearincommandsyntax.
SymbolUsage|The'or'symbolisusedtodenoteachoice.
Eithertheargumentontheleftortheargumentontherightmaybeused.
Example:YES|NOInthisexample,YESorNOmaybespecified.
[]Denotesoptionalarguments.
Thoseargumentsnotenclosedinsquarebracketsarerequired.
Example:APPLDESTDEST[ALTDEST]Inthisexample,DESTisarequiredargumentandALTDESTisoptional.
{}Somedocumentsusebracestodenoterequiredarguments,ortogroupargumentsforclarity.
Example:COMPARE{workload}-REPORT={SUMMARY|HISTOGRAM}Theworkloadvariableisrequired.
TheREPORTkeywordmustbespecifiedwithavalueofSUMMARYorHISTOGRAM.
DocumentationConventionsviiiIBMCL/SuperSessionforz/OSCustomizationGuideSymbolUsage_Defaultvaluesareunderscored.
Example:COPYinfileoutfile-[COMPRESS={YES|NO}]Inthisexample,theCOMPRESSkeywordisoptional.
Ifspecified,theonlyvalidvaluesareYESorNO.
Ifomitted,thedefaultisYES.
Thesymbolindicatesablankspace,whenneededforclarity.
SymbolsReadThisFirstixSymbolsxIBMCL/SuperSessionforz/OSCustomizationGuideChapter1.
OptionsforSettingUpYourNetworkThischapterexplainstheoptionsforsettingupyournetworkwithCL/SuperSession.
Youwilllearnhowto:vSpecifyentrypointdialogsvConnectuserstoanetworkentrypointvCreateaVTAMresourcedefinitionforCL/SuperSessionvAuthorizethepathvIdentifythenewnamesoftheproductlibrariesandfindACBnamesinthoselibrariesNetworkEntryPointsAnetworkentrypointestablishesaninterfacetoaCL/SuperSessionentrypointdialogforphysicalterminalusers.
Youcanuseanentrypointdialogtomakedecisionsabouttheuserwhoisloggingon.
Youmightdecide,forexample,thatoneusershouldgetmultisessionaccess,anothershouldgetsingle-sessionaccess,andanothershouldnotbeallowedanyaccessatall.
WhenauserlogsontoanapplicationidentifiedbyaHOSTGATEcommand,thedialogidentifiedinthecommandreceivescontrol.
(RefertoLogonDialogSequenceforanoverviewofthedialogsequence.
)MorethanonenetworkentrypointcanbedefinedinasingleCT/Engineexecutionenvironment(thatis,z/OSaddressspace).
However,eachmustreferenceauniqueVTAMAPPL(knownasentrypoint,entrypointapplication,orentrypointconfiguration).
YouspecifytheCL/SuperSessionentrypointdialogintheHOSTGATEcommandin&rhilev.
RLSCMDS(KLGCHGGW).
Bydefault,theentrypointdialogisKLGATEWY.
HowTerminalsConnecttoCL/SuperSessionYoucanusefourmethodsforconnectinguserstoanetworkentrypoint:vTheVTAMinterprettablevTheVTAMLOGAPPLvTheCT/EngineFORWARDcommandinconjunctionwithaVTAMLOGAPPLvSIMLOGONfromCLSDSTPASSapplicationsThemethodyouchoosedependsonhowyouwantuserstoaccessthesystemandwhatyouwanttopresenttothem.
VTAMLOGAPPLYoucanspecifytheVTAMLOGAPPLparametertoconnectaterminalautomaticallywithanetworkentrypoint.
IfyouusetheVTAMLOGAPPLparameterwithCL/SuperSessiontoconnectyourterminals,VTAMautomaticallylogstheterminalontoCL/SuperSession.
Underthismethod,auserwhologsoffordisconnectsasessionwithCL/SuperSessioncangetbacktoVTAMandselectanotherentrypointorapplication.
CopyrightIBMCorp.
1997,20151FORWARDCommandwiththeVTAMLOGAPPLTheFORWARDcommand,usedtogetherwithaVTAMLOGAPPL,letsyouconnectauserdirectlytoanetworkentrypointandlocktheuserintothatentrypoint.
YoucanspecifyatemporaryentrypointasthetargetoftheLOGAPPL,andtheFORWARDcommandroutesthelogontothepermanentnetworkentrypoint.
Forexample,toforwarduserstotheKLGICFG1entrypoint,followthesesteps:1.
Duringinstallationyoucopied&thilev.
TLSSAMP(KLSVTLST)intoSYS1.
VTAMLST(newname).
MembernewnamecontainstheAPPLstatementsthatdefinetheapplicationstoVTAM.
Thismemberisconsideredthemajornode.
AddthefollowinglinetoSYS1.
VTAMLST(newname):FORWARDAPPLACBNAME=KLVF1,AUTH=(ACQ,NVPACE,PASS)FORWARDistheAPPLname,andKLVF1istheACBnameforadummyAPPLfromwhichtheFORWARDcommandroutesausertotheselectedentrypoint.
2.
Addthiscommandtotheendof&rhilev.
RLSCMDS(KLSSTART):FORWARDKLVF1applnamewhereapplnameistheapplicationnetnameoftheselectedentrypoint.
Note:Ifused,FORWARDshouldalwaysbethelastcommandcodedinKLSSTARTtoensurethatallcommandsareexecuted.
3.
UsetheVTAMLOGAPPLtoconnectterminalstoFORWARD.
4.
ToactivatetheFORWARDAPPL:a.
ShutdowntheCT/Engineaddressspace.
b.
Inactivateandthenreactivatethenewnamemajornode.
c.
RestarttheCT/Engineaddressspace.
Alternatively,youcanissueatemporaryFORWARDcommandwithoutrecyclingtheaddressspace:1.
AddtheFORWARDAPPLtoanewmajornodewithauniquename.
2.
Activatethenewmajornode.
3.
IssuetheFORWARDcommandfromtheCUAOperator.
Note:Ifyouusethetemporarymethod,theFORWARDcommandremainsineffectonlyuntilthenexttimeCL/SuperSessionisshutdown.
BecauseusersareforwardedimmediatelyfromtheLOGAPPLentrypoint,theycannotreturntoVTAMunlessanoperatordeactivatestheLOGAPPL.
YoucanavoidusingtheVTAMLOGAPPLbyissuingtheFORWARDcommandwiththeLOGAPPLoperand,howeveritisnotrecommended.
TheFORWARDLOGAPPLgeneratesaqueuedlogon,whichconflictswiththeAPPLDEFSIMLOGONqueuedlogon(see"SIMLOGONfromCLSDSTPASSApplications").
WithouttheLOGAPPLparameter,theFORWARDcommandiscompatiblewiththeAPPLDEFSIMLOGON.
FordetailedinformationontheFORWARDcommand,seetheOperator'sGuide.
SIMLOGONfromCLSDSTPASSApplicationsWhenauserconnectstoaCLSDSTPASSapplication,thesessionbetweentheuser'sterminalandCL/SuperSessionterminates.
WhenthesessionwiththeFORWARDCommandwiththeVTAMLOGAPPL2IBMCL/SuperSessionforz/OSCustomizationGuideCLSDSTPASSapplicationends,theuser'sphysicalterminaleitherreturnstoVTAMcontrol,orispassedbacktothegatewayortoaLOGAPPL.
IfthegatewayrequiresuserIDandpasswordvalidation,theusermustreenterthisinformationtogetbacktotheMainMenuafterloggingoffanapplication.
WiththeSIMLOGONparameteroftheAPPLDEFcommand,youcanautomaticallyreestablishasessionafterterminationofasessionwithaCLSDSTPASSapplication.
Inaddition,ifthegatewayrequiresuserIDandpasswordvalidation,youcanuseoperandsoftheSIMLOGONparametertopassthisinformationtoCL/SuperSessionwhenthesessionisreestablished.
Fromtheuser'sperspective,controlreturnsdirectlytotheMainMenuwhentheapplicationterminates.
Warning:YoucannotuseboththeAPPLDEFSIMLOGONandtheFORWARDLOGAPPLforthesameapplication.
TheFORWARDLOGAPPLgeneratesaqueuedlogon,whichconflictswiththeSIMLOGONqueuedlogon.
WithouttheLOGAPPLparameter,theFORWARDcommandiscompatiblewiththeAPPLDEFSIMLOGON.
VTAMResourceDefinitionsforCL/SuperSessionCL/SuperSessionrequirethedefinitionofaVTAMapplicationmajornode(VBUILD)andaseriesoflogicalunits(APPLs)tosupportthefollowing:vEntryPointsACL/SuperSessionentrypointcommand,foundin&rhilev.
RLSCMDS(KLGCHGGW),establishesanapplicationaccesspathintothenetwork.
EachentrypointrequiresauniqueAPPLandcansupportmanyusers.
Networkentrypoints(alsoknownasconfigurations)includeKLGICFG1,KLGICFG2,andKLGICFG3(ACBnames&lsvt1,&lsvt2,&lsvt3respectively).
Note:BesuretosetahighEASvaluefortheentrypointapplications;forexample,ifyouexpecttohave2,500usersonKLGICFG1,setEAS=2500inthe&lsvt1APPLinSYS1.
VTAMLST(newname).
vCUAOperatorTheCUAoperatorprovidesaninterfaceforoperatorcommandsandfunctionsthroughpull-downmenusandpop-upwindows.
InthedistributedSYS1.
VTAMLST,itsdefaultACBnameis&lsvt5,anditsnetworknameisCUAOPER.
vIMS/DCVirtualMTOs(IMSsupportonly)IMS/DCMTOvirtualsessionsimplementIMSsessionservices.
EachIMS/DCMTOvirtualterminalrequiresoneAPPL.
InSYS1.
VTAMLST,theACBnamesforthevirtualMTOsare&lsmto1through&lsmto4.
vVirtualTerminalsVirtualterminalpoolsconsistofoneormoreAPPL-definedlogicalunitsusedbyCL/SuperSessiontoestablishvirtualsessionswithVTAMapplicationprograms.
EachvirtualterminalrequiresoneAPPL.
InSYS1.
VTAMLST(newname),theACBnamesandnetworknamesforthevirtualterminalsare&lsvt00through&lsvt70.
SpecifyinganEntryPointforLU1DevicesTheentrypointsprovidedwithCL/SuperSessiondonotworkwithLU1devices.
LU1devicesneedtheirownentrypoints,whichcannotbemultisessionandcannotusetabledisplays.
Tableservicescanbeused.
TheLU1cannotusePSM.
Furthermore,theirconfigurationcannotspecifyKLSLMODasthelogmodepanel.
SIMLOGONfromCLSDSTPASSApplicationsChapter1.
OptionsforSettingUpYourNetwork3IfanyofyourusershaveLU1terminals,followthisproceduretocreateanetworkentrypointforthem.
1.
Copy&thilev.
TLSSAMP(KLGLU1SO)and&thilev.
TLSSAMP(KLGLU1PW),showninFigure1andFigure3onpage6,into&rhilev.
RLSPNLSandmodifythemforyourenvironment.
)OPTIONLEVEL(1))COPYKLSATTR1)DECLAREnscope(local)*N(o)passwordchangeqscope(local)*Questionmarkovtypescope(local)*Variableovtypemsgareascope(local)*Messageareaapplscope(share)*Desiredapplicationviguserscope(session)*Useridvigpswdscope(session)*Password)PROLOGUE*Variableovtypecontainscarriagereturncharacters,**followedbycharacterstoovertypethepassword,**followedbyalinefeed.
*setovtype'\0D#0D*0D%15'setn'N'/*N(o)passwordchange*/setq''/*Questionmark*/setappl''/*Nullouttheapplication*/)BODYEnteruserid:_viguser=Entercurrentpassword:%vigpswd=&ovtypeEnterdesiredapplication:_appl=Doyouwanttochangeyourpassword&q_n=&msgarea)EPILOGUEif&syskey=''setsyskey'ENTER'if!
&vsplangsetvsplang'1'*Selectadialogtochangepasswordonrequest.
*if&nne'N'/*Ifrequestingtochange*/dialog'KLGLU1PW'/*password-gotonew*//*passwordpanel.
*/Figure1.
Part1of2SampleLogonPanelforLU1DevicesSpecifyinganEntryPointforLU1Devices4IBMCL/SuperSessionforz/OSCustomizationGuideif!
&appldo/*Ifnodesiredappl,*/setmsgarea'EnterDesiredApplication'setviguser''/*lettheuserstartover*/setvigpswd''/*again.
Enteruserid/pwsd*/reshow/*Reshowthispanel*/end*Setresflagto1willbypassuserid/passwordresolutioninGNTRY*setresflag11/*Setresflagto1*/*Stripleadingblanks,foldtoUC,blankOKasenddelimiter.
*if'&vigpswd'do/*Ifpasswordspecified,*/setvigpswdfold(LJUST('&vigpswd'8))/*Uppercaseand*/seti(INDEX('&vigpswd'removeleadingblanks*/if&i>=0setvigpswd(SUBSTR('&vigpswd',0,&i))setvigpswd'&encdec('&vigpswd')'/*Encryptit*/end*Stripleadingblanks,foldtoUC,blankOKasenddelimiter.
*if'&viguser'dosetviguserfold(LJUST('&viguser'8))seti(INDEX('&viguser',''))if&i>=0setviguser(SUBSTR('&viguser',0,&i))end*Stripleadingblanks,foldtoUC,blankOKasenddelimiter.
*if(setrc(VALIDATE('&viguser''&encdec('&vigpswd')'))eq4or(VALIDATE('&viguser''&encdec('&vigpswd')')))eq8dosetvigrnpsw''selectgntryendelseif&rc=0dosetvigrnpsw''selectgntryendelsedosetmsgarea'&vtpdfval'setvigpswd''setviguser''reshowend)TERMsetmsgarea''Figure2.
Part2of2SampleLogonPanelforLU1DevicesSpecifyinganEntryPointforLU1DevicesChapter1.
OptionsforSettingUpYourNetwork5)OPTIONLEVEL(1))COPYKLSATTR1)DECLAREiscope(local)*Indexplaceholderovtypescope(local)*Overtypecharactersvigpswdscope(local)*Newpasswordvigpswd2scope(local)*Verifynewpasswordvignpswdscope(share)*Newpasswordmsgareascope(local)*Messageareavsplangscope(share)*NLSlanguage,defaultto1syskeyscope(share)*SYSKEY)PROLOGUE*Variableovtypecontainscarriagereturncharacters,**followedbycharacterstoovertypethepassword,**followedbyalinefeed.
*setovtype'\0D#0D*0D%15')BODYEnternewpassword:%vigpswd1=&ovtypeVerifynewpassword:%vigpswd2=&ovtype&msgarea)EPILOGUEif&syskey=''setsyskey'ENTER'if!
&vsplangsetvsplang'1'Figure3.
Part1of2SampleNewPasswordEntryforLU1UsersSpecifyinganEntryPointforLU1Devices6IBMCL/SuperSessionforz/OSCustomizationGuide2.
IfKLGATEWYisnotin&rhilev.
RLSPNLS,copy&thilev.
TLSPNLS(KLGATEWY)into&rhilev.
RLSPNLS.
AddthefollowingcodetotheKLGATEWYdialog,rightaftertheLOGON_USER:label:If&appl/*IsthisanLU1device*/pass&appl(&syslmode'&viguser'&encdec('&vigpswd')'')3.
Createanewgatewayconfigurationmemberin&rhilev.
RLSPARM.
Copy&rhilev.
RLSPARM(KLGICFG1)intothenewconfigurationmember,andgloballychangeKLGLGONtoKLGLU1SO.
4.
In&rhilev.
RLSCMDS(KLGCHGGW)addaHOSTGATEcommandtodefineanewCL/SuperSessionentrypoint.
AssociatethisHOSTGATEcommandwiththenewgatewayconfigurationmemberandwiththebroadcastgroupoftheLU1users.
FordetailedinformationontheHOSTGATEcommand,seetheOperator'sGuide.
VTAMAuthorizedPathCL/SuperSessionsupportstheVTAMauthorizedpathwhenitrunsAPF-authorized.
Theresultingperformanceimprovementsarepassedontoallusersandmaybeparticularlyvaluableforvirtualsessions.
InTLVLOADconcatenation,alllibrariesmustbeAPF-authorized(thatis,identifiedintheIEAAPFxxmemberofSYS1.
PARMLIB).
ThelibrariesasdistributedcontaintheproperlinkageeditorSETCODEvalues.
TheinitializationstreammustspecifyAPF=Y.
Adefaultinitializationstreamisprovidedin&rhilev.
RLSPARM(KLSSYSIN).
WhenSTEPLIBconcatenationisAPF-authorized,KLSSYSINdefaultstoAPF=Y.
WhentheVTAMauthorizedpathis*ProcesstheENTERkey.
*if&syskey='ENTER'do/*Enterkeypressedsetvigpswd1fold(LJUST('&vigpswd1'8))/*stripleadingblanksseti(INDEX('&vigpswd1',''))if&i>=0setvigpswd1(SUBSTR('&vigpswd1',0,&i))setvigpswd2fold(LJUST('&vigpswd2',''))seti(INDEX('&vigpswd2',''))if&i>=0setvigpswd2(SUBSTR('&vigpswd2',0,&i))if('&vigpswd1'eq'')or('&vigpswd2'eq'')dosetvigpswd1''setvigpswd2''setmsgarea'Newpasswordmustbeentered'reshowendif'&vigpswd1'ne'&vigpswd2'dosetvigpswd1''setvigpswd2''setmsgarea'Newpasswordmustbeverified'reshowendsetvignpswd'&encdec('&vigpswd1')'if'&vignpswd'dosetvigpswd1''setvigpswd2''setmsgarea'Passwordchanged'returnendend)TERMsetmsgarea''*/*/Figure4.
Part2of2SampleNewPasswordEntryforLU1UsersSpecifyinganEntryPointforLU1DevicesChapter1.
OptionsforSettingUpYourNetwork7used,youmayincludetheSRBEXIT=YESoperandinanyAPPLstatementthatdefinestheCT/Engineoperator,entrypointdialogs,orvirtualterminals.
Note:YoumayspecifySRBEXIT=YESonlyifCL/SuperSessionisAPF-authorized.
WheretoFindtheACBNamesintheProductLibrariesTohelpyoucustomizewithoutcausingACBnamestoconflict,Table3showsthelocationsofACBnamedefinitionsprovidedwithCL/SuperSession.
Table1.
ACBNamesProvidedwithCL/SuperSession.
ACBNameLibraryMemberApplication&lsvt0&rhilev.
RLSCMDSKLSSTARTCT/Engineoperatorfacility&lsvt1&lsvt2&lsvt3&rhilev.
RLSCMDSKLGCHGGWCL/SuperSessionentrypoints,definedinHOSTGATEcommands&lsvt5&rhilev.
RLSCMDSKLSSTARTCUAOperator&lsvt4&rhilev.
RLSPARMKLVINVPOVTAMProgramOperator(VPO)&lsmto1through&lsmto4&rhilev.
RLSCMDSKLICIMTOIMSvirtualMTOs,definedinVSMcommands&lsvt00through&lsvt70&rhilev.
RLSCMDSKLS$VSMSVirtualterminalsCL/SuperSessionStartedTaskJCLandRuntimeDatasetsThestartedtaskJCLandruntimedatasetsforCL/SuperSessionfollow.
UsethestartedtaskJCLtostarttheCL/SuperSessionaddressspace.
VTAMAuthorizedPath8IBMCL/SuperSessionforz/OSCustomizationGuideThefollowingDDstatementsarerequired.
STEPLIBTheCL/SuperSessionloadmodulelibrarymaybespecifiedviaSTEPLIBormayoptionallybeplacedinthez/OSsystemLINKLIST.
IfitisplacedintheLINKLIST,theSTEPLIBisnotnecessary.
APFauthorizationisrequired.
TLVLOADAswithSTEPLIB,theTLVLOADDDstatementalsoreferstothe//*//*PROCEDURE:KLS-EXECUTECL/SuperSession//*//*FUNCTION://*//*THISSAMPLEPROCEDUREMAYBEUSEDTOSTARTCL/SuperSession.
//*THEUSERMAYTAILORTHISJCLTOSATISFYINSTALLATION//*DATASETNAMINGANDSYSOUTHANDLINGREQUIREMENTS.
//*CL/SuperSessionCANBERUNASABATCHJOBORASASTARTEDTASK.
//*//*NOTES://*//*THESTEPLIBDDSTATEMENTISREQUIREDONLYIFTHECL/ENGINE//*PRODUCTDOESNOTRESIDEINALINKLISTLIBRARY.
//*//*THETLVLOADDDSTATEMENTMUSTREFERTOTHEEXECUTIONLIBRARY.
//*//*IFANEXTERNALSECURITYSYSTEMWILLBEUSEDTOPERFORM//*NETWORKACCESSVALIDATION,THEEXECUTIONLIBRARYMUSTBE//*APFAUTHORIZED.
//*//*ITISRECOMMENDEDTHATTHEEXECUTIONLIBRARYIS//*APFAUTHORIZED.
//*//*&THILEV//*ISTHESMPTARGETHILEVELQUALIFIER//*&RHILEV//*ISTHERUN-TIMENON-VSAMHILEVELQUALIFIER//*//KLSPROCPFX='&THILEV',//RPFX='&RHILEV',//MEMORY=0M,CL/SuperSessionREGIONALLOCATION//SYSIN=KLSSYSIN,INITLIBRARYSTARTUPMEMBER//SOUT=ALOGANDDEBUGGINGOUTPUTCLASS//*//IEFPROCEXECPGM=KLV,REGION=&MEMORY.
TIME=1440//STEPLIBDDDISP=SHR,DSN=&PFX.
.
TLVLOAD//TLVLOADDDDISP=SHR,DSN=&RPFX.
.
RLSLOAD//DDDISP=SHR,DSN=&PFX.
.
TLSLOAD//DDDISP=SHR,DSN=&PFX.
.
TLVLOAD//TLVCMDSDDDISP=SHR,DSN=&RPFX.
.
RLSCMDS//DDDISP=SHR,DSN=&PFX.
.
TLSCMDS//DDDISP=SHR,DSN=&PFX.
.
TLVCMDS//TLVPARMDDDISP=SHR,DSN=&RPFX.
.
RLSPARM//DDDISP=SHR,DSN=&PFX.
.
TLSPARM//DDDISP=SHR,DSN=&PFX.
.
TLVPARM//TLVPNLSDDDISP=SHR,DSN=&RPFX.
.
RLSPNLS//DDDISP=SHR,DSN=&PFX.
.
TLSPNLS//DDDISP=SHR,DSN=&PFX.
.
TLVPNENU//TLVH0ENUDDDISP=SHR,DSN=&PFX.
.
TLVHPENU//TLVLOGDDSYSOUT=&SOUT//TLVSNAPDDSYSOUT=&SOUT//TLVSYSINDDDISP=SHR,DSN=&RPFX.
.
RLSPARM(&SYSIN),FREE=CLOSE//ABNLIGNRDDDUMMY*TOTURNABENDAIDOFF*Figure5.
CL/SuperSessionStartedTaskJCLCL/SuperSessionStartedTaskJCLandRuntimeDatasetsChapter1.
OptionsforSettingUpYourNetwork9CL/SuperSessionloadlibrary.
ThislibrarycontainsallCL/SuperSessionloadmodules,plusanyinstallationwrittenexits.
Note:TheTLVLOADdatasetaccessedthroughtheTLVLOADDDstatementrequiresthesameAPFauthorizationastheSTEPLIBloadlibrary.
TLVCMDSTheTLVCMDSDDstatementidentifiesthecommandlistlibrary.
CommandlistsareprocessedautomaticallyduringCL/SuperSessioninitializationandcanbeinvokedfromaz/OSconsoleorCL/SuperSessionoperatorterminal.
SeeAppendixB,"CL/ENGINEProductLibrariesReference,"onpage181forthesyntaxtobeusedwheneditingthislibrary.
TLVPARMTheTLVPARMDDstatementidentifiestheinitializationlibrarythatcontainsvariousmembersthatconfigureparticularproductfeaturesandfunctions,suchasoperatorcapabilitiesandVIEWLOG.
SeeAppendixB,"CL/ENGINEProductLibrariesReference,"onpage181forthesyntaxtobeusedwheneditingthislibrary.
TLVPNLSTheTLVPNLSDDstatementidentifiesthepanellibrarythatdefinesallpanelsforCL/SuperSessionusers.
SeetheDialogLanguageReferenceManualforinformationaboutcodingSSPLdialogs.
TLVH0ENUTheTLVH0ENUDDstatementidentifiesthehelplibrary.
TLVLOGTheTLVLOGDDstatementdefinesthedatsasetcollectingCL/SuperSessionlogoutput.
DCBattributesaresetinternally.
Theblocksizedefaultsto6144butmaybeoverriddenbyastartupparameter.
ThisdatasetprovidesaprintedrecordofallCL/SuperSessionactivity,includingoptionallyinvokeddebugginginformation.
TLVSNAPTheTLVSNAPDDstatementdefinesasequentialdatsasettocollectaCL/SuperSessionformattedSNAPintheeventofCL/SuperSessionabnormaltermination.
TLVSNAPDCBattributesarespecifiedwithinCL/SuperSessiontoconformtoz/OSSNAPmacrorequirements.
Note:DonotcodeDCBattributesontheTLVSNAPDDstatement.
TLVSYSINThisdatasetisreadbyCL/SuperSessionatsysteminitialization.
Itspecifiestheinitializationlibrarymember(KLSSYSIN)thatcontainssystemstartupparameters.
RecommendedinitializationparametersaredistributedinRLSPARM.
SeeAppendixB,"CL/ENGINEProductLibrariesReference,"onpage181forthesyntaxtobeusedwheneditingthislibrary.
ABNLIGNRIfABEND-AIDisinstalled,thisDDstatementdisablesitsothatusableCLproblemdocumentationisproducedforthesupportteam.
CL/SuperSessionStartedTaskJCLandRuntimeDatasets10IBMCL/SuperSessionforz/OSCustomizationGuideThePROCparametersareasfollows:PFXThehigh-levelprefixofCL/SuperSessiontargetdatasetnames.
Inthisexample,thehigh-levelprefixis&THILEV.
RPFXThehigh-levelprefixofCL/SuperSessionruntimedatasetnames.
Inthisexample,thehigh-levelprefixis&RHILEV.
SYSINThemembernamewithinRLSPARMthatcontainsCL/SuperSessioninitializationparameters.
Inthisexample,thenameisKLSSYSIN.
MEMORYTheCT/Engineaddressspaceregionrequirements.
Inthisexample,theregionrequirementsare0M.
SOUTTheSYSOUTclassname.
Inthisexample,thenameisA.
CL/SuperSessionStartedTaskJCLandRuntimeDatasetsChapter1.
OptionsforSettingUpYourNetwork11CL/SuperSessionStartedTaskJCLandRuntimeDatasets12IBMCL/SuperSessionforz/OSCustomizationGuideChapter2.
VirtualTerminalsAphysicalterminalisusuallyallowedonlyonesessionatatime,soCT/Enginecreatesvirtualterminals.
Virtualterminalssimulatephysicalterminalsforsessionsbetweenusersandapplications,buteachvirtualterminalcansupportmanysessionsonbehalfofmanyusers,andeachusercanhavesessionsonmorethanonevirtualterminal.
WhenauserselectsaSINGLEorMULTIapplication,CT/Engineallocatesavirtualterminal,whichlogsontotheapplicationfortheuser.
Thisresultsinavirtualsession.
VTAMAPPLstatementsdefinevirtualterminallogicalunitstocreatevirtualsessions.
Fromtheuser'sperspective,avirtualsessionbetweenaterminalandanapplicationisthesameasastandardterminal-to-applicationsession.
However,avirtualsessionactuallyconsistsoftwodistinctphysicalsessions:vonesessionbetweentheuserandCT/EnginevonesessionbetweenCT/EngineandthedestinationapplicationDuringinstallationyoucopied&thilev.
TLSSAMP(KLSVTLST)intoSYS1.
VTAMLST(newname).
MembernewnamecontainstheAPPLstatementsthatdefinetheapplicationstoVTAM.
Thismemberisconsideredthemajornode,andthelogicalunitsdefinedbyAPPLstatementsaretheminornodes.
EachvirtualterminalrequiresoneAPPL.
ForcompleteinformationontheAPPLstatement,refertotheIBMpublicationVTAMInstallationandResourceDefinition.
SomeoftheAPPLstatementsincludedinthe&thilev.
TLSSAMPmajornodememberKLSVTLSTlooklikethoseshowninChapter2,"VirtualTerminals".
KLSVTLSTcontainstheSTS1.
VTAMLSTAPPLdefinitionsthatarerequiredtoimplementtheproductsdistributedonthetape.
IfyouchangetheAPPLnamesorACBnames,besuretochangetheappropriatecommandsin&rhilev.
RLSCMDS.
TheKLVINVPOmemberin&rhilev.
RLSPARMistheonlymemberaffectedbyKLSVTLST.
EAS=1isrecommendedforallvirtualterminalsnotsupportingparallelsessions.
Thesevirtualterminalswillnothaveenoughactivesessionstowarrantthehalf-orfull-pageof(E)CSAusedbyVTAMasasessionhash-tablewhenEASisspecifiedasordefaultstogreaterthan44.
Figure6.
CL/SuperSessionVirtualSessionCopyrightIBMCorp.
1997,201513CopyKLSVTLSTintoSYS1.
VTAMLSTandactivateitbeforeattemptingtorunthesampleconfigurations.
**LicensedMaterials-PropertyofIBM****5601-B28(C)CopyrightIBMCorp.
2005,2015.
****USGovernmentUsersRestrictedRights-Use,duplicationor****disclosurerestrictedbyGSAADPScheduleContractwithIBMCorp.
*****MEMBER:KLSVTLSTSYS1.
VTAMLSTAPPLDEFINITIONS****FUNCTION:*VBUILDTYPE=APPL*CT/ENGINEOPERATORFACILITY.
REFERTOMEMBERKLSSTARTIN*DDNAMETLVCMDSFORTHECOMMANDSTHATACTIVATETHE*OPERATORACBS.
-VTPREF-0APPLAUTH=(ACQ,PASS,NVPACE),PARSESS=YES*CT/ENGINECUAOPERATORFACILITY.
REFERTOMEMBERKLSSTARTIN*DDNAMETLVCMDSFORTHECOMMANDSTHATACTIVATETHE*OPERATORACBS.
-VTPREF-5APPLAUTH=(ACQ,PASS,NVPACE),PARSESS=YES*CT/ENGINEVTAMPROGRAMOPERATORFACILITY.
*REFERTOMEMBERKLVINVPOINDDNAMETLVPARM.
-VTPREF-4APPLAUTH=(ACQ,PASS,SPO)*SAMPLESUPERSESSION/GATEWAYAPPLICATIONS.
REFERTO*KLGCHGGWINDDNAMETLVCMDSFORTHEHOSTGATECOMMANDS.
-VTPREF-1APPLAUTH=(ACQ,PASS,NVPACE),PARSESS=YES-VTPREF-2APPLAUTH=(ACQ,PASS,NVPACE),PARSESS=YES-VTPREF-3APPLAUTH=(ACQ,PASS,NVPACE),PARSESS=YES*VIRTUALTERMINALDEFINITIONSREQUIREDFORIMS.
*REFERTOMEMBERKLICIMTOINDDNAMETLVCMDSFORTHE*VSMCOMMANDS.
**-VMTOPREF-1THRU4ARETHEVIRTUALMTOLU'S.
-VMTOPREF-1APPLEAS=1,AUTH=(ACQ,NVPACE)-VMTOPREF-2APPLEAS=1,AUTH=(ACQ,NVPACE)-VMTOPREF-3APPLEAS=1,AUTH=(ACQ,NVPACE)-VMTOPREF-4APPLEAS=1,AUTH=(ACQ,NVPACE)*VIRTUALTERMINALDEFINITIONSFORPOOLVIRTPARS.
*SEEMEMBERKLS$VSMSINDDNAMETLVCMDSFORTHE*VSMCOMMANDS.
-VTPREF-00APPLAUTH=(ACQ,NVPACE),PARSESS=YES*VIRTUALTERMINALDEFINITIONSFORPOOLSVIRTDEDANDIINPOOL.
*SEEMEMBERKLS$VSMSINDDNAMETLVCMDSFORTHE*VSMCOMMANDS.
-VTPREF-01APPLAUTH=(ACQ,NVPACE),PARSESS=YES-VTPREF-02APPLAUTH=(ACQ,NVPACE),PARSESS=YES-VTPREF-03APPLAUTH=(ACQ,NVPACE),PARSESS=YES-VTPREF-04APPLAUTH=(ACQ,NVPACE),PARSESS=YESVirtualTerminals14IBMCL/SuperSessionforz/OSCustomizationGuide-VTPREF-05APPLAUTH=(ACQ,NVPACE),PARSESS=YES-VTPREF-06APPLAUTH=(ACQ,NVPACE),PARSESS=YES-VTPREF-07APPLAUTH=(ACQ,NVPACE),PARSESS=YES-VTPREF-08APPLAUTH=(ACQ,NVPACE),PARSESS=YES-VTPREF-09APPLAUTH=(ACQ,NVPACE),PARSESS=YES-VTPREF-10APPLAUTH=(ACQ,NVPACE),PARSESS=YES*VIRTUALTERMINALDEFINITIONSFORPOOLS*VIRTPASS11THROUGH70*VIRT327011THROUGH70*MODEL211THROUGH70*MODEL311THROUGH70*MODEL411THROUGH70*MODEL511THROUGH70*MODEL911THROUGH70*HCFPOOL11THROUGH70*TSOESA11THROUGH20*TSOPOOL11THROUGH20*SEEMEMBERKLS$VSMSINDDNAMETLVCMDSFORTHE*VSMCOMMANDS.
-VTPREF-11APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-12APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-13APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-14APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-15APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-16APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-17APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-18APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-19APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-20APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-21APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-22APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-23APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-24APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-25APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-26APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-27APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-28APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-29APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-30APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-31APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-32APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-33APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-34APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-35APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-36APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-37APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-38APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-39APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-40APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-41APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-42APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-43APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-44APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-45APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-46APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-47APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-48APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-49APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-50APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-51APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-52APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-53APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-54APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-55APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-56APPLAUTH=(ACQ,NVPACE),EAS=1VirtualTerminalsChapter2.
VirtualTerminals15-VTPREF-57APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-58APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-59APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-60APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-61APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-62APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-63APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-64APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-65APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-66APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-67APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-68APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-69APPLAUTH=(ACQ,NVPACE),EAS=1-VTPREF-70APPLAUTH=(ACQ,NVPACE),EAS=1*HELPDESK/HAOAPPLIDS-HAOPREF--HAOSEQN-PHDAPPLAUTH=(ACQ,NVPACE),PARSESS=YES-HAOPREF--HAOSEQN-GTWYAPPLAUTH=(ACQ,NVPACE),PARSESS=YES-HAOPREF--HAOSEQN-PPSRAPPLAUTH=(ACQ,NVPACE),PARSESS=YES-HAOPREF--HAOSEQN-PHXLAPPLAUTH=(ACQ,NVPACE),PARSESS=YES-HAOPREF--HAOSEQN-PHXSAPPLAUTH=(ACQ,NVPACE),PARSESS=YESOtherAPPLParametersWhendefiningorchangingvirtualterminalsinAPPLstatements,payparticularattentiontothefollowingparameters:vPARSESSvAUTHvEASvMODETABvDLOGMODvSRBEXITvSESSLIMPARSESSParameterCertainapplications,suchastheCT/Engineoperatorfacility,supportparallelsessions.
Aparallelsessionletsmanyusersshareavirtualterminaltocommunicatewiththeapplication.
PARSESS=YESindicatesthattheapplicationsupportsparallelsessions.
PARSESS=NOisthedefault.
Formoreinformationonparallelsessions,see"VirtualTerminalSharing"onpage24.
AUTHParameterTheAUTHparameterdetermineswhetherthisapplicationprogramhastheauthoritytousecertainVTAMfunctions.
ACQDetermineswhetherCT/EnginecanissueOPNDSTACQUIREandSIMLOGON.
NVPACEDeactivatesVTAMmessagetrafficonsessionsusingthispath.
NVPACEisoptional;itisusedforperformancepurposesonly.
PASSDetermineswhethertheapplicationcanissueCLSDSTPASS.
VirtualTerminals16IBMCL/SuperSessionforz/OSCustomizationGuideEASParameterTheEASparameterspecifiestheapproximatenumberofconcurrentsessionsbetweentheapplicationandotherlogicalunits(LU-to-LUsessions).
VTAMusesthespecifiedvalueinalookupschemetofindtherepresentationofasessionbetweentheapplicationprogramandanotherlogicalunit.
SpecifyingtheproperEASparametervalueforvirtualterminalACBscansaveasignificantamountofcommonstorage.
EAS=1causesVTAMtochainalltheapplication'ssessionstogetherandrunthatonechainforalltraffictotheapplication.
EAS=1isrecommendedforallapplicationsexceptvvirtualterminalsthathavemorethan44concurrentapplicationsessions(withdifferentapplications)vvirtualterminalsthatsupportparallelsessions(forexample,theCT/Engineoperatorfacility)ThedefaultisEAS=509(forVTAM3.
2–3.
4)orEAS=491(forearlierreleasesofVTAM).
Valuesgreaterthan44andlessthan494allocateahalf-pagelookuptable.
VTAMlooksupthenetworkaddressesinincomingtrafficandsearchesthechainselectedforthesessionblock.
AnEASvaluegreaterthan494allocatesafull-pagelookuptableinECSA.
Theperformancegaintakeseffectonlywhenhundredsofusersaccessasingleapplication.
ItisrecommendedthatyousettheEASparameteraccordingtothefollowingguidelines:vForvirtualterminalsthatsupportparallelsessions,specifyEAS=2000.
vForvirtualterminalswithmorethan44concurrentapplicationsessions,followtheguidelinesprovidedintheIBMmanualVTAMCustomization.
vFormostotherapplications,specifyEAS=1.
Toconservestorage,specifyLIMIT=44intheVSMDEFINEcommand.
(SeetheOperator'sGuide.
)Forexample:&lsvt11APPLEAS=1,AUTH=(ACQ,NVPACE),ACBNAME=&lsvt11MODETABParameterIndefiningvirtualterminals,youmayalsochoosealogmodetabletoassociateeachlogmodeentrywithasetofsessionparametersfortheapplication.
Todoso,specifytheMODETABparameterinthevirtualterminalAPPLdefinition.
IfCT/EnginedoesnotfindanentryforMODETAB,itsearchestheIBMdefaultlogmodetable(ISTINCLM).
See"DefiningtheLogmodeTableEntry"onpage22.
ForinformationregardingtheimplementationofKLSINCLM,seetheProgramDirectory.
DLOGMODParameterTheDLOGMODparameterspecifiesthenameofthedefaultlogmodetableentry.
(See"DefiningtheLogmodeTableEntry"onpage22.
)ThedefaultisD4B32782(formodel2).
Thisdefaultisignoreduponsuccessfullogmoderesolution.
EASParameterChapter2.
VirtualTerminals17Forinformationaboutdefaultlogmodesforvirtualprinters,seeChapter4,"VirtualPrinters,"onpage33.
SRBEXITParameterSRBEXIT=YESspecifiesthatyouwantVTAMexitroutinestoruninSRBmode(supervisorstate,key0),ratherthaninTCBmode(problemstate).
IfSRBEXIT=YES,theaddressspacemustbeAPF-authorized.
SESSLIMParameterTheSESSLIMparameterallowsasessionlimitforaVTAMapplication.
IftheSESSLIMparameterisspecifiedforavirtualterminalusedbyaDEDICATEpool,SIMLOGONandmultipleCLSDSTPASSwillnotwork.
Therefore,youshouldnotusetheSESSLIMparameterforVTAMAPPLstatementsthatdefinevirtualterminalsinaDEDICATEpool.
Formoreinformationonvirtualterminalpools,seeChapter3,"VirtualTerminalPools,"onpage19.
DLOGMODParameter18IBMCL/SuperSessionforz/OSCustomizationGuideChapter3.
VirtualTerminalPoolsAsetofvirtualterminalsiscalledavirtualterminalpool.
Eachpoolspecifiesthevirtualterminalsthatmakeupthepoolanddescribesthecharacteristicsoftheapplicationsthatwillusethepool.
AfteryouhavedefinedvirtualterminalstoVTAM,asexplainedinChapter2,"VirtualTerminals,"onpage13,youcaneitherselectapredefinedvirtualterminalpooloryoucanusetheVSMcommandtodefineanewvirtualterminalpoolormodifyanexistingpool.
Youcanalsoselectvirtualterminalpoolsdynamicallyatsessioninitiationtime.
Whenyoudefineanapplicationsession,youspecifyavirtualterminalpoolthatmatchesthetargetapplication'sexpectationsandbehavior.
Whenauserstartsasessionwiththeapplication,CT/Engineselectsavirtualterminalfromthepoolthatyouspecified.
UsetheVSMCommandtodefinevirtualterminalpoolstoCT/Engine.
UseAPPLDEFcommandsandsessionprofilestoassociatepoolswithapplications.
Besuretospecifyavirtualterminalpoolinamultisessionorsinglesessionapplicationdefinition.
DonotspecifyavirtualterminalpoolforCLSDSTPASSapplicationdefinitions.
TopicsdiscussedinthischapterarevselectingpredefinedpoolsvdefininganewvirtualterminalpoolvdefiningthelogmodetableentryvvirtualterminalsharingvTSOconsiderationsvCICSconsiderationsvhowvirtualterminalsareselectedfromvirtualterminalpoolsvselectingavirtualterminalpooldynamicallyvassigningspecificvirtualterminalswithinapoolvdefiningvirtualterminalsdynamicallyvdeletingvirtualterminalinformationvdisplayingsessioninformationforavirtualterminalSelectingPredefinedPoolsCL/SuperSessioncanusetheAPPLDEFcommandtoassociateanapplicationwiththecorrectvirtualterminalpool.
Table2onpage20correlatesapplicationtypeswithdistributedvirtualterminalpools.
CopyrightIBMCorp.
1997,201519Table2.
DefaultVirtualTerminalPools.
TypeofApplicationPoolCT/EngineoperatorfacilityVIRTPARSTSOwithVTAM3.
3ESAandaboveTSOESACICSwithAutoinstallVIRT3270CICSwithoutAutoinstall&DEFPOOLNetVieworNCCFVIRTPASSIMS&DEFPOOLIINIINPOOLIBMOMEGAMONVIRT3270HCFHCFPOOLVMVIRT3270VM/VSCSVIRT3270MostotherapplicationsVIRT3270Sincethedefaultpoolsarealreadypartoftheconfiguration,youneedonlyspecifythemintheCL/SuperSessionAPPLDEFcommand.
Forexample,todefineaTSOapplicationnamedTSOA,youwouldusethepoolnamedTSOPOOL.
YourAPPLDEFcommandwouldlooklikethis:APPLDEFTSOA-DEST(yournetworknameforTSO)-DESC('TSOSYSTEMA')-MESSAGE('UPAT2:00P.
M.
')-ORDER(1)-MULTSESS(YES)-POOL(TSOPOOL)FordetailedinformationontheAPPLDEFcommand,see"DefiningApplications"onpage57.
Also,refertotheCL/SuperSessionOperator'sGuideformoreinformation.
DefiningaNewVirtualTerminalPoolWhenyoufollowedtheinstructionsintheBasicConfigurationGuide,youchosethepropervirtualterminalpoolforeachapplicationandincreasedthevirtualterminalpoolsize,ifyouneededtodoso.
Tocustomizefurther,youmightwanttodefineyourownvirtualterminalpools.
TheVSMDEFINEcommanddefinesapoolofvirtualterminallogicalunits(LUs)canbesharedbyproducts(suchasCL/SuperSession)thatuseCT/Engine.
VSMDEFINEcommandsarenormallyincludedinthestartupcommandlisttoensurethatallvirtualterminalpoolsareavailableassoonasCT/Engineinitializationiscomplete.
YoucanissuemorethanoneVSMDEFINEcommandforthesamepool.
Afteryoudefineapool,subsequentVSMDEFINEcommandsaddvirtualterminalstothatpool.
ThisisusefulifyouwanttoexpandthenumberofvirtualterminalswithoutstoppingandstartingtheCT/Engineaddressspace.
SelectingPredefinedPools20IBMCL/SuperSessionforz/OSCustomizationGuideYoucanhaveoneVSMDEFINEcommandforeachvirtualterminal.
However,ifyournamingconventionusessequentialnumbering,youcanusetheTHROUGHparametertospecifyaseriesofvirtualterminals.
Note:IfCL/SuperSessionwillhaveotherproductsasmenuselections,refertothoseproductmanualsforVSMrequirements.
Figure7showssomeofthedefaultVSMcommandscontainedin&thilev.
TLSCMDS(KLS$VSMS).
ThefirstcommandintheKLS$VSMSmemberdefinesthepoolVIRTPARSwiththefollowingparameters:VIRTPARSSpecifiesthepooltoassociatewithaseriesofvirtualterminals.
PARALLELMeansthatavirtualterminalinthispoolcanhavemorethanoneconcurrentsessionwithasingleVTAMapplication.
ThesecondVSMDEFINEcommandinFigure7includestheparameters:VSMDEFDenotestheVirtualSessionManagerDEFINEcommand.
Itdefinesthevirtualterminalpoolusedtoestablishvirtualsessions.
VIRTDEDSpecifiesthepooltoassociatewithaseriesofvirtualterminals.
&lsvt00IsthefirstAPPLIDorLUnameintheVSMcommandthatdefinesthepool.
TH(10)Generatesentriesforterminals&lsvt01through&lsvt10.
LOGMODESpecifiestheVTAMlogmodetableentryusedtoestablishthevirtualsession.
DEFERMeansthattheVTAMACBOPENforthevirtualterminalACBisdeferreduntilauseractivatesasession.
DEDICATESpecifiesthatavirtualterminalinsessionwithanotherapplicationcannotbesharedwithotherpools.
*STANDARDVSMPOOLSFORVIRTUALTERMINALSESSIONS.
*VSMDEFVIRTPARS-VTPREF-00LOGMODE(&DEFLMODE)DEFERPARALLELVSMDEFVIRTDED-VTPREF-01TH(10)LOGMODE(&DEFLMODE)DEFERDEDICATEVSMDEFVIRTPASS-VTPREF-11TH(70)LOGMODE(&DEFLMODE)DEFERPASSVSMDEFVIRT3270-VTPREF-11TH(70)LOGMODE(&DEFLMODE)DEFERVSMDEFMODEL2-VTPREF-11TH(20)LOGMODE(&DEFLMODE)DEFERVSMDEFMODEL3-VTPREF-21TH(30)LOGMODE(&DEFLMODE)DEFERVSMDEFMODEL4-VTPREF-31TH(40)LOGMODE(&DEFLMODE)DEFERVSMDEFMODEL5-VTPREF-41TH(50)LOGMODE(&DEFLMODE)DEFERVSMDEFMODEL9-VTPREF-51TH(60)LOGMODE(&DEFLMODE)DEFERFigure7.
DefaultVSMPoolsin&thilev.
TLSCMDS(KLS$VSMS)DefiningaNewVirtualTerminalPoolChapter3.
VirtualTerminalPools21ThethirdandfourthVSMDEFINEcommandsincludetwoadditionalparameters,PASSandTIMEOUT.
PASSSpecifiesthatsessionsestablishedthroughthisVSMpoolmustbepassedonlyonceduringthelifeofthesession.
TIMEOUTSpecifiesthemaximuminactivityperiodallowedforvirtualsessionsthatusethispool.
ForacompletedescriptionoftheVSMDEFINEcommand,seetheCL/SuperSessionOperator'sGuide.
DefiningtheLogmodeTableEntryToestablishavirtualsession,VTAMmustfindinalogmodetablethelogmodeentrynamespecifiedduringthelogonrequest.
VTAMsearchesfirstinthelogmodetablespecifiedwiththeMODETABparameteroftheAPPLstatementthatdefinesthevirtualterminal.
Ifthelogmodeentrynameisnotthere,VTAMthensearchesintheIBMdefaultlogmodetable(ISTINCLM).
Formoreinformationaboutthistable,seetheIBMdocumentcalledVTAMCustomization.
CL/SuperSessionusestheLOGMODEparameteroftheVSMDEFINEcommandtoselectanewlogmodeentrynameforthevirtualterminalpool.
ItisimportanttorememberthatavirtualsessionbetweenCL/SuperSessionandtheapplicationdoesnothavetoabidebythesamebindrulesasasessionbetweenthephysicaldeviceandtheapplication.
CL/SuperSessionchecksforthefollowingsessioncharacteristics:vSNAornon-SNAvqueriableornonqueriablevscreensizeThelogmodeusedbyCL/SuperSessionappliestothevirtualterminal,notthephysicalterminal.
CL/SuperSessiondoesnotsupportapplicationsthatattempttousemorethanoneexplicitpartition.
ThevirtualterminalcanbeSNAornon-SNA,regardlessofthesessionprotocolforthephysicalterminal.
Thevirtualterminalscreensizecanhavedifferentcharacteristicsthanthephysicalterminal.
Thevirtualterminalsupportsthe3270QUERYorderonqueriablesessions,evenifthephysicalterminaldoesnot.
ApplicationsthatSetTheirOwnSessionParametersWhenanapplicationsessionbegins,alogmodeentryfromtheterminalsuggestssessionparameters.
IMSandCICS(withoutAutoinstall)overridethesessionparameterssuggestedbytheterminal,anduseinsteadtheparametersfoundintheirowntables.
ForIMS,thelogmodemustbenon-SNAiftheIMSdefinitionsarenon-SNA,andSNAifSLU2TERMTYPESareused.
Thisrequirementisindependentofthephysicalsessionandlogmode.
CICSwithoutAutoinstallignoresthelogmodenameintheCINIT(terminallogonrequest)whenthevirtualterminaldeviceisdefinedintheTCT.
See"CICSConsiderations"onpage25.
DefiningaNewVirtualTerminalPool22IBMCL/SuperSessionforz/OSCustomizationGuideAlthoughyoucannotuselogmodestocontrolsessionparameterswiththeseapplications,youcanusepoolsforthispurpose.
Fortheseapplications,therefore,youshouldsetupaseparatepoolforeachterminaltype(model2,3,4,5,or9)whosecharacteristicsmustcarrytotheapplication.
SelectingaLogmodeEntryforExtendedFunctionsVirtualterminalsessionswithextendeddatastreamfunctions,APLfunctions,orbothmustusealogmodeentryforaqueriableLU0orLU2device.
&thilev.
TLSSAMP(KLSINCLM)containsasamplelogmodetableforthesesessions.
Ifyouintendtouseextendeddatastreamsupport,andifcompatiblelogmodesarenotavailableinthelogmodetablethatyouplantouseforvirtualterminals,youmayneedthissupplementarytable.
Someapplicationsrequireorperformbetterwithaspecificsetofsessioncharacteristics.
Usetheadministratorfunctionstocustomizeyourlogmodetableforthoseapplications'pools.
SeetheBasicConfigurationGuide.
SelectingaLogmodeEntryDynamicallyWhenauseraccessesanapplication,CL/SuperSessioninvokesthedialogKLSLMOD.
TheKLSLMODdialoglooksforthelogmodetableentryintheonlinelogmodetable.
Otherwise,theproductusesdefaultlogmodes.
Tosetthedefaultlogmodeentrynameforvirtualsessionstothelogmodeentrynameusedforthephysicalterminal,performthefollowingsteps:1.
MakesurethattheCL/SuperSessionvirtualdevicesarereferencingtheproperlogmodetable.
Ifyouareusingthedefaultlogmodetable,skiptostep2.
Otherwise,checkthattheMODETABparameterisreferencingthecorrecttableonallthevirtualterminalAPPLdefinitionsinSYS1.
VTAMLST(newname).
Forexample:KLST0001APPLAUTH=(ACQ,NVPACE),MODETAB=KLSINCLMKLST0002APPLAUTH=(ACQ,NVPACE),MODETAB=KLSINCLM2.
FromtheAdministratorMenu,selectUpdateLogmodeTable.
MakesurethatthevaluefortheDEFLMODEfieldoftheDEFAULTentryisD4B32782.
Fordetailedinformationonusingtheadministratorfunctionstocreateandmodifythelogmodetable,seetheBasicConfigurationGuide.
Note:ThelogmodetablecreatedthroughtheadministratorfunctionsoverridesanycustomizationyoudoindialogKLSLMOD.
Therefore,youshouldcustomizeyourlogmodetablethroughtheadministratorfunctions,notthroughKLSLMOD.
DonotmodifydialogKLSLMOD.
UnspecifiedScreenSizeBindCL/SuperSessionoffersupportfortheunspecifiedscreensizebindonvirtualsessionswithhostapplications.
Whenthehostapplicationdoesnotsupportunspecifiedscreensizebinds,dialoglogic(aidedbylogmodecustomizationthroughonlineadministratorfunctions)candetermineanappropriatelogmodenameforthosevirtualsessions.
InthiswayyoucanconvertthenetworktouseaApplicationsthatSetTheirOwnSessionParametersChapter3.
VirtualTerminalPools23commonunspecifiedscreensizebindimageandcompensateforhostapplicationsthatdonotcurrentlysupportunspecifiedscreensizebinds.
ExplicitPartitionOperationCL/SuperSessionsupporthostapplicationsthatusetheexplicitpartitioncapabilityofcertain3270-familyterminals.
Thiscapability,whichisusedbyNetViewandGDDM,isavailableinthefollowingcommonlyusedterminals:`3179G`3180`3192D`3192G`3290Supportiscurrentlylimitedtoasingleexplicitpartitionwithidentifierzero.
VirtualTerminalSharingWhenyouintroducevirtualterminalstoyournetwork,youintroduceadditionalVTAMresources,becausevirtualterminalsuseCSAandotherresources.
Withthepropervirtualterminalsharingtechniques,youcancutdownonVTAMresourcerequirementsforyourvirtualterminals.
Therearetwotypesofvirtualterminalsharing:vACBsharing,inwhichanOPEN-ACBcanhaveOPEN-DESTstosessionswithmorethanoneVTAMapplicationvparallelsessions,inwhichanOPEN-ACBcanhavemorethanoneOPEN-DESTtothesameVTAMapplicationVirtualdevicescanbesharedacrossmorethanonevirtualterminalpoolandcanalsobesharedamongVTAMapplications.
Forexample,thesamevirtualterminalcanbeusedforavirtualsessionwithTSO,IMS,CICS,andNetView,foreitherasingleusersessionoracombinationofusersessions.
However,thevirtualterminalcannotbeinsessionwiththesameapplicationmorethanonce,unlessboththevirtualterminalandtheapplicationcansupportparallelsessions.
ParallelsessionscanbeestablishedonlyifvtheVTAMapplicationAPPLcansupportparallelsessionsandhascodedinSYS1.
VTAMLST(newname)vthevirtualdevicehasPARSESS=YEScodedinSYS1.
VTAMLST(newname)vthevirtualterminalpooldefinition(theVSMDEFINEcommand)specifiesthePARALLELparameterCT/Engine,OMEGAMON,andTSOcansupportparallelsessions.
Unlessyouuseparallelsessions,eachapplicationrequiresasmanyvirtualdevicesasthemaximumnumberofconcurrentusers.
Applications(suchasIIN)thatusemorethanoneCLSDSTPASStopasssessionsinhibitvirtualterminalsharing.
Thevirtualterminaltreatsapassedsessionasasessionterminationfollowedbyasessioninitiation,andreceivesnoinformationtocorrelatethetwosessions.
Iftwosuchsessionpassesareintransitatthesametime,thevirtualterminalcannotdeterminewhichofthemwascompletedfirst.
Thevirtualterminalcannotcontrolsessionpassing.
Toavoidcrossedsessions,CT/EnginerequiresthatyouspecifyinadvancewhichsessionswillbepassedUnspecifiedScreenSizeBind24IBMCL/SuperSessionforz/OSCustomizationGuide(CLSDSTPASS)morethanonce.
Terminalsthatsupportsuchasessionarenotselectedtosupportanother,andshouldbeassignedtoapoolwiththeDEDICATEparameter.
Applicationsthatpassaterminal(CLSDSTPASS)exactlyonceanddosoquickly(forexample,NetView)onlytemporarilyinhibitsharing,whilethepassisoccurring.
Onceasessionhasbeenpassed,itisnotpassedagain,andthevirtualterminalcansupportanothersuchsession.
ThistypeofapplicationshouldbeassignedtoapoolwiththePASSparameter.
Ifapooldoesnotcontainenoughvirtualterminalsforyourneeds,youmayseethismessageonyourscreen:SessionestablishmentfailedbecausetheVirtualSessionManagercouldnotallocateresources.
Inthiscase,besuretoincreaseyourpoolsize.
Otherwise,yourusersmaynotbeabletoestablishthesessionstheyneed.
TSOConsiderationsTSO'sRECONNECTprocessingrequiresmorethanoneCLSDSTPASS.
Toaccommodatethisrequirement,thevirtualterminalpooldefinitionmustincludetheDEDICATEparameter,whichdoesnotallowparallelsessionsorACB-sharing.
Therefore,ifyouruserswillhaveSINGLEsession(ratherthanMULTIsession)accesstoTSO,youmaywanttousetheDEDICATEparameteroftheVSMDEFINEcommandwhenyoudefinevirtualterminalpoolsforTSO.
(SeetheCL/SuperSessionOperator'sGuide.
)However,becauseCL/SuperSessionestablishesphysicalsessionswithoutbreakingvirtualsessions,definingaDEDICATEpoolforTSOasamultisessionapplicationisunnecessaryandwastesresources.
TousegraphicswithTSO,makesurethatthephysicalterminalisusingtheproperlogmodeandcansupportextendeddatastreams.
TSOhardwarepartitioningofthe3290isnotsupported.
TSOusesmorethanoneexplicitpartitionwithnon-zeroidentifiersforthe3290devices.
CICSConsiderationsYourcustomizationneedsforCICSvirtualterminalsdependonwhetheryouareusingCICSwithorwithoutAutoinstall.
CICSwithoutAutoinstallCICSusesaterminalcontroltable(TCT)todescribevirtualterminalcharacteristics.
ItdoesnotusetheVTAMdescriptionoftheterminal.
IntheTCTyoumustdefineallterminals,bothphysicalandvirtual,thatwillbeinsessionwithCICS.
&thilev.
TLSSAMP(KLSCTCT)givessampleTCTentries.
ThisexampleshowsaVSMpooldefinitionthatyoucanusetodefinevirtualterminalsforaCICSregion.
VSMDEFCICSMOD3KLST0001TH(50)LOGMODE(&DEFLMODE)DEFERVirtualTerminalSharingChapter3.
VirtualTerminalPools25YoumustspecifyseparateTCTentriesforeachoftheKLST0001-KLST0050virtualterminalsdefinedinthisVSMcommand.
Youshouldspecifythefollowingparameters:vNETNAME=KLST0001todefinetheKLST0001virtualterminal.
vTheparametersthatdetermineterminalmodel.
Forexample,amodel3requirestheDEFSCRN=(32,80)orALTSCRN=(32,80)parameter,dependingonhowyouspecifythescreensizeinyourCICSregion'sTCT.
vTRMTYPEtospecifywhethertheterminalisSNAornon-SNA.
vFEATUREtospecifycertainhardwarefeaturesthatdifferentterminalmodelsmighthave.
Forexample,formodel3s,youmightincludecolor,highlight,orps.
Figure8andFigure9onpage27eachshowaTCTentryinaproductionCICSsystem.
TheentryinFigure8setsupanSNAterminal;theentryinFigure9onpage27setsupanon-SNAterminal.
BothentriesworkinconjunctionwiththefollowingCICSMOD3pooldefinition:VSMDEFCICSMOD3KLST0001TH(50)LOGMODE(D4A32783)DEFERNote:Thisisonlyanexample;yourTCTdefinitionswillbedifferent.
KLST0050KLST0050DFHTCTTYPE=TERMINAL,XTRMIDNT=M050,XTRMTYPE=LUTYPE2,XACCMETH=VTAM,XALTSCRN=(32,80),XALTSFX=3,XBRACKET=YES,XBUFFER=1536,XRUSIZE=2048,XCHNASSY=YES,XDEFSCRN=(24,80),XERRATT=(LASTLINE,INTENSIFY),XFEATURE=(DCKYBD,UCTRAN,3270E,AUDALARM,SELCTPEN,XCOLOR,HILIGHT,PS),XGMMSG=YES,XNETNAME=&lsvt50,XRELREQ=(NO,YES),XTIOAL=(4000),XTRMMODL=2,XTRMPRTY=0,XTRMSTAT=(TRANSCEIVE)XLOGMODE=0Figure8.
TCTEntryfortheFirstTerminalintheCICSMOD3VSMPool(SNA)CICSwithoutAutoinstall26IBMCL/SuperSessionforz/OSCustomizationGuideCICSwithAutoinstallWhendefiningvirtualterminalsforusebyaCICSsystemwithautomaticinstallationofterminals(Autoinstall),youdonotneedtospecifydiscreetpoolsofvirtualterminalsforusebyparticularmodeltypes.
NordoyouneedtospecifytheNODEparameterontheVSMDEFINE.
Instead,CICSusesautomaticinstallationmodelsdefinedinRDOwithCEDA,andauserprogramtomaptheterminalnametothenetname.
IBMsuppliesanexampleuserprogram(calledDFHZATDX),codedinAssembler.
Ifautomaticinstallationisactive,theuserprogramreceivescontrolatinstallationwhenaVTAMlogonrequestisreceivedfromaresourcewhoseNETNAMEisnotintheTCT.
Theuserprogramispassedaparameterlistoffivecontiguousfullwords:1.
Functionfield.
Byte1indicatestherequesttype.
ThisisX'F0'forinstall.
Theremainingthreebytesarereserved.
2.
Pointertoidentifierfield.
Theidentifierfieldconsistsofa2-bytelengthfield,followedbytheNETNAMEoftheresourcerequestingLOGON,forexample,aCL/SuperSessionvirtualterninal.
3.
Apointertoanarrayofnamesofeligibleautomaticinstallationmodels.
Thearrayisprecededbya2-bytefielddescribingthenumberofthe8-bytenameelementinthearray.
4.
Pointertoa21-bytefieldtoreturninformationtothecallingprogram.
vAUTINSTNAME-8bytesvTERMINAL-4bytesvPRINTER-4bytesvALTPRINTER-4bytesvStatusbyte-1byteToreturninformation,theuserprogramsetstherequiredinformationinthereturninformationfield.
Thestatusbytemustbesettobinaryzeros.
5.
PointertotheVTAMCINITrequestunit.
Thedataisprecededbya2-bytelengthfieldindicatingthelengthoftheCINITrequestunit.
SeetheIBMmanualCICSCustomizationGuideformoreinformationontheautoinstallprocess.
KLST0050DFHTCTTYPE=TERMINAL,XACCMETH=VTAM,XNETNAME=KLST0050XRELREQ=(NO,YES),XGMMSG=YES,XFEATURE=(DCKYBD,UCTRAN,3270E,AUDALARM,SELCTPEN,XCOLOR,HILIGHT,PS),XERRATT=(LASTLINE,INTENSIFY),XBRACKET=YES,XRUSIZE=2048,XTRMIDNT=M050,XTRMMODL=2,XTRMPRTY=0,XTRMSTAT=(TRANSCEIVE),XTRMTYPE=L3277,XDEFSCRN=(24,80),XALTSCRN=(32,80),XTIOAL=3000,XALTSFX=3XLOGMODE=0(Non-SNA)Figure9.
TCTEntryfortheFirstTerminalintheCICSMOD3VSMPoolCICSwithAutoinstallChapter3.
VirtualTerminalPools27TheCINITrequestunitcanbeparsedtolocateanyuserdatapassedwiththerequest.
Anexampleuserprogramtolocateuserdatasuppliedwithalogonrequestisin&thilev.
TLSSAMP(KLSZATDX).
Topassthephysicalterminaltotheautoinstalluserprogram,youmustdefinetheCICSapplicationwithUSERDATA='&SYSTERM'ontheAPPLDEFcommand.
HowVirtualTerminalsAreSelectedfromVirtualTerminalPoolsCL/SuperSessionassignsvirtualterminalsinlast-in-first-out(LIFO)sequence.
YoucanusetheNODEparameteroftheVSMDEFINEcommandtochangethevirtualterminalassignmentsequence.
See"AssigningSpecificVirtualTerminalswithinaPool"onpage29.
SelectingaVirtualTerminalPoolDynamicallyCL/SuperSessionletsyouselectavirtualterminalpooldynamically.
WhenyouspecifyPOOL=vsmpoolinanAPPLDEFcommand,vsmpoolidentifiesaspecificvirtualterminalpooldefinedbyaVSMDEFcommand.
WhenyouspecifyPOOL='&DEFPOOL',thevirtualterminalpoolisassigneddynamicallyfromtheDEFPOOLvariable,whichissetthroughtheadministratorfunctions.
(Seethei>BasicConfigurationGuide.
)Note:IfyoudonotspecifythePOOLparameterontheAPPLDEFcommand,thegatewaypassesterminalcontroldirectlytothedestinationapplicationandbreaksthegatewaysessionwiththeterminal(VTAMCLSDSTPASS).
FordetailedinformationabouttheAPPLDEFcommand,see"DefiningApplications"onpage57.
Also,refertotheCL/SuperSessionOperator'sGuideformoreinformation.
ExampleAsshowninthisexample,CICSregionsthatuseaTCTtodefinethecharacteristicsofeligiblephysicalterminalsmightrequireyoutoselecttheterminalpooldynamically.
IBMprovidessamplegatewayconfigurationmembers,APPLDEFcommands,VSMpools,anddialogstohandledynamicpoolselectionformostterminaltypes.
HereisanAPPLDEFcommandforaCICSapplication.
Thisdefinitionis&rhilev.
RLSCMDS(KLSCAPLS).
APPLDEFCICSSS-DEST=CICS1-DESC='CICS(PASSTHRU/MULTSESS)'-POOL='&DEFPOOL'-MULTSESS=YES-GROUP=200Inthisexample,thevalueoftheAPPLDEFPOOLparameterdefaultstothevalueofthevariable&DEFPOOL.
Thevariable&DEFPOOLselectsavirtualterminalpooldynamically,basedontheterminalmodel.
Whenausersignsontothegateway,thevalueof&DEFPOOLissetbythelogmodetablecustomizedandmaintainedthroughtheadministratorfunctions.
CICSwithAutoinstall28IBMCL/SuperSessionforz/OSCustomizationGuideAssigningSpecificVirtualTerminalswithinaPoolTheNODEparameteroftheVSMDEFcommandcontrolsterminalallocationinaspecificvirtualterminalpool.
Onceyouselectapool,theNODEparameterdetermineswhichvirtualterminalisallocatedfromthatpool.
TheNODEparametercanspecifyvanyvalidstringexpressionorliteralstringvavariabletobesetbyadialogduringsessioninitiationThisisusefulifyouwanttoselectthevirtualterminalbyeitheruserIDorphysicalterminalID.
ThevariableusedastheNODEvaluemustbedeclaredasasharedvariablein&thilev.
TLSPNLS(KLSSDCL).
Ifthisisnotdone,whenanewwindowiscreatedtheNODEvariablewillbenullsandNODEwillnotberesolved.
Note:ForastringexpressioninaVSMcommand,use&SYSEDIT,not&SUBSTR.
(&SUBSTRdoesnotworkwithNODE.
)Theformatfor&SYSEDITis&SYSEDIT((offset,length)string)IfyoudonotspecifytheNODEparameter,virtualterminalsareassignedinLIFOsequence.
MappingVirtualTerminalsThefollowingexamplesshowhowtousemorethanoneVSMDEFcommandtodefineasinglevirtualterminalpool.
ThesevirtualterminalmappingtechniquesusetheNODEparameteroftheVSMDEFcommand.
ThevariableusedastheNODEvaluemustbedeclaredasasharedvariable.
Example1ThisexamplechangesthefirstcharacterofthephysicalterminalnetworknametoV,wherethephysicalterminalnamesareKLST0002,KLST0003,andsoon.
VSMDEFVIRTPOOLVLST0002LOGMODE=&DEFLMODEDEFER-NODE='V&SYSEDIT((1,7)&SYSTERM)'VSMDEFVIRTPOOLVLST0003DEFERVSMDEFVIRTPOOLVLST0004DEFERVSMDEFExample2ThisexampleprefixesthephysicalterminalnetworknameX,wherethephysicalterminalnamesareKLST001,KLST002,andsoon.
VSMDEFVIRTPOL2XLST001LOGMODE=&DEFLMODEDEFER-NODE='X&SYSTERM'VSMDEFVIRTPOL2XLST002DEFERVSMDEFVIRTPOL2XLST003DEFERVSMDEFExample3ThisexamplesuffixesthephysicalterminalnetworknameZ.
TheZiseitherusedasthelastcharacterofaseven-charactername,orsubstitutedforthelastcharacterofaneight-charactername.
Forthisexample,thephysicalterminalnamesareKLST001,KLST002,andsoon.
AssigningSpecificVirtualTerminalswithinaPoolChapter3.
VirtualTerminalPools29Note:Thisexampleassumesthatallphysicalterminalnetworknamesareeithersevenoreightcharacterslong.
VSMDEFVIRTPOL3KLST001ZLOGMODE=&DEFLMODEDEFER-NODE='&SYSEDIT((0,7)&SYSTERM)Z'VSMDEFVIRTPOL3KLST002ZDEFERVSMDEFVIRTPOL3KLST003ZDEFERVSMDEFExample4Thisexampleusesacomplexstringexpression.
VSMDEFVIRTPASSKLST60TH(9)LOGMODE(&DEFLMODE)PASS-NODE='KLST&SYSEDIT((1,3)&SYSTERM)'VSMDEFVIRTPASSKLST60AVSMDEFVIRTPASSKLST60BVSMDEFVIRTPASSKLST60CVSMDEFVIRTPASSKLST60DVSMDEFVIRTPASSKLST60EVSMDEFVIRTPASSKLST60FThevirtualterminalnameisderivedbyappendingthesecondthroughfourthcharactersofthephysicalterminalIDtothecharacterstringKLST.
The&SYSEDITfunctionextractsthesecondthroughfourthcharactersfromthephysicalterminalname,&SYSTERM.
BecausetheTHROUGHparametercannotbeusedtodefinenon-numericvirtualterminalsuffixes,severalVSMcommandsareusedtodefinethispool.
Youcandefinethispoolinassociationwithaseriesofnon-SNAphysicalterminalswhosenamescontainchannelunitaddresses.
Forexample,agroupofVTAMphysicalterminalswithnamesT600throughT60FcanbemappedtovirtualterminalsKLST600throughKLST60Fbythismethod.
Example5Thisexampleusesthequestionmark()wildcardcharactertoassignusersfromtwolocationstovirtualterminalsthatreflecttheirrespectivelocations.
Thefirst3charactersofthephysicalterminalsforthetwolocationsareAPTandBPT.
VSMDEFCICSPOOLAPT000TH(030)LOGMODE=&DEFLMODEDEFER-NODE='&SYSEDIT((0,3)&SYSTERM).
'VSMDEFCICSPOOLBPT000TH(030)LOGMODE=&DEFLMODEDEFERNote:TheNODEparameterispropagatedtoallterminalsinapool,soitisrequiredononlyoneVSMDEFcommand.
DefiningVirtualTerminalsDynamicallyIfyouhavealargenumberofvirtualterminalstoallocate,usingVSMDEFcommandstocreateandmaintainthenecessarypoolsmightinvolveagreatdealofwork.
Tosimplifythetask,youcancreatevirtualterminalsdynamically,asuserssignon,byusingaphysical-to-virtualterminalone-to-onemappingtechnique.
EachvirtualterminalnameisderivedfromaspecificphysicalterminalIDoruserID.
Thisexampledynamicallyaddsavirtualterminaltothepoolastheuserlogson.
Theadvantageofthistechniqueisthatyoudon'thavetoissueVSMcommandstoMappingVirtualTerminals30IBMCL/SuperSessionforz/OSCustomizationGuidemaintainvirtualterminalpools,andyousaveonACBstorage.
Eachvirtualterminalnameinthisexampleconsistsofthelastfourcharactersofthephysicalterminalname.
Forexample,physicalterminalIDC12AZ0A3mapstovirtualterminalIDZ0A3.
1.
Createdummyvirtualterminalpoolsin&rhilev.
RLSCMDSmemberKLS$VSMS.
Forexample,VSMDEFPASSPOOLDUMMYLOGMODE(&DEFLMODE)DEFERPASS-NODE='&VIRTTERM'VSMDEFNOPASSDUMMYLOGMODE(&DEFLMODE)DEFER-NODE='&VIRTTERM'2.
Createadialoginyour&rhilev.
RLSPNLSwiththefollowingdialogcode:)OPTIONSLEVEL(1))INITSETVIRTTERM'&SUBSTR('&SYSTERM',4,4)'COMMAND('AS''*SYSVLG*''VSMDEFPASSPOOL&VIRTTERMDEFER')COMMAND('AS''*SYSVLG*''VSMDEFNOPASS&VIRTTERMDEFER')Inthiscode,AS'*SYSVLG*'issuesthecommandsonbehalfoftheVIEWLOGoperator.
ThecommandrepliesarethenrecordedintheVIEWLOGdataset.
Thisdialogneedstobespecifiedasaprofileinitialdialogsothatitexecutesduringauser'sinitializationafterentryvalidation.
Note:ThistechniquestillrequiresthateachvirtualterminalisdefinedinSYS1.
VTAMLST(newname)andthatVIEWLOGisenabled.
Optional:Tocloseavirtualterminalthathasbeendynamicallyallocated,reviewexamplecodesinCLSEACB,CLSEACB1,CLSEACB2,andCLSEACB3in&rhilev.
RLSSAMP.
TheexamplesexplainhowtocloseACBsthatyoudynamicallyallocatedandpreventthevirtualterminalsfromtakingupextrastorage.
DeletingorRedefiningaVirtualTerminalPoolDefinitionTodeleteavirtualterminalpool,usetheVSMDELETEcommand.
VSMDELETEdeactivatesallvirtualsessionsusingvirtualterminalsinthespecifiedpool,andclosestheVTAMACBs.
Toredefineanexistingpool,issuetheVSMDELETEcommand,andthenreissueaVSMDEFINEcommandtodefinethepoolwithnewattributes.
ImportantUsetheVSMDELETEcommandwithcaution.
Ifyoudeleteapoolthatcontainsvirtualterminalsdefinedinmorethanonepool,thevirtualterminalsaredeletedfromeverypoolinwhichtheyaredefined.
Furthermore,whenyouissuetheVSMDELETEcommand,youdisableallvirtualterminalsinthedeletedpool,includingthosecurrentlyinuse.
UsetheCLOSEcommand,nottheVSMDELETEcommand,tocloseanindividualterminal.
IfyouCLOSEanindividualterminalinaspecificpool,theterminalisdeletedfromeverypoolinwhichitisdefined.
IfyouCLOSEallthevirtualterminalsinapool,thepoolisdeleted.
Donotdeletethedefaultpool$DEFAULT.
If$DEFAULTisdeletedordefinedincorrectly,theresultswillbeunpredictable.
DefiningVirtualTerminalsDynamicallyChapter3.
VirtualTerminalPools31FordetailedinformationonCLOSEandVSMDELETE,seetheCL/SuperSessionOperator'sGuide.
DisplayingVirtualTerminalInformationTheVSMDISPLAYcommandprovidesdetailedsessioninformationontheapplicationorvirtualterminalLUspecifiedinthecommand.
TheinformationconcernsvactivevirtualsessionswithaspecificvirtualterminalvactivevirtualsessionswithaspecificVTAMapplicationTheVSMLISTcommanddisplaysstatisticalinformationaboutavirtualterminalpool.
Thisinformationincludesvtheidentifiersofallpools,orofthespecifiedpoolonlyvpoolparametersspecifiedinpooldefinitionsvthecurrentnumberofeachofthefollowing:–Activesessionsforvirtualterminalsinthepool.
Becauseofvirtualterminalsharing,thisnumbercouldbesignificantlyhigherthanthenumberofopensessions.
–Availablevirtualterminals.
Virtualterminalsareconsideredavailableuntiltheyreachtheirlimitofactivesessions(specifiedwiththeLIMITparameteroftheVSMDEFINEcommand).
–Opensessions(thatis,ACBsopenedbyVTAM).
IfyouspecifyDEFERanddonotspecifyPARALLELintheVSMDEFINEcommand,thenumberofopensessionsprovidesthehigh-watermarkforthenumberofactivesessionswithanyoneapplication.
–Deferredsessions.
Thetotalnumberofopenanddeferredsessionsshouldequalthenumberofvirtualterminalsdefinedforthepool.
–Sessionsallowedforeachvirtualterminalinthepool,asspecifiedbytheLIMITparameteroftheVSMDEFINEcommand.
FordetailedinformationontheVSMDISPLAYandVSMLISTcommands,seetheCL/SuperSessionOperator'sGuide.
DeletingorRedefiningaVirtualTerminalPoolDefinition32IBMCL/SuperSessionforz/OSCustomizationGuideChapter4.
VirtualPrintersAvirtualprinterisanACBassociatedwithanetworkprinter.
Virtualprintersletvariousapplicationsshareaphysicalprinter.
Forexample,ifyouhaveonephysicalprinterusedbybothIMSandCICS,youcancreatevirtualprintersthatsharethephysicalprinter,withorwithoutareleaserequest(RELREQ)protocol.
Youcanthenrouteallprintingtothevirtualprinter,whichmanagesthephysicalprinterandpreventsconflictsamongapplications.
YoucanalsoimplementavirtualprintertodirectprintingtoSYSOUT.
TheadvantageofusingSYSOUTisthateitherJESorz/OShandlesroutingtotheappropriatedevice.
Herearesomeofthebenefitsofvirtualprinters:vVirtualprintersreduceresourceconsumptionandincreasedeviceavailabilitybyeliminatingthenecessitytoinitiateandterminateasessionwiththephysicalprinterforeachprintrequest.
vYoucanreplacethephysicalprinterdefinitionsinapplicationterminalcontroltableswithstaticvirtualprinterdefinitions,whichcanthenbeassociateddynamicallywithspecificphysicalprinters.
vVirtualprinterspermitaconstantflowofprintstreamsfrommanyapplicationsinfirst-in-first-out(FIFO)order.
VirtualPrinterSharingAnynumberofCT/Engineandnon-CT/Engineapplicationscanshareavirtualprinter.
Ausercanshareavirtualprinterwithanyotheruser,regardlessoftheapplicationinuse.
Anyapplicationthatrequiresaccesstoaphysicalprintercangainaccessatanytime.
CT/EnginemanagestheflowofdatatotheprinterbyenforcingtheSNAbracketprotocol.
TheSNAbracketprotocolgovernstheattachmenttothenamedphysicalprinter.
Whenseveralvirtualprintersessionswishtobeginabracket,VPRINTERresolvestheirrequestsinFIFOsequence.
Contentionlosersaresentanexceptionresponsesensedatacodeofx'08020000'(InterventionRequired).
Whenavirtualsessionthathaspreviouslybeenacontentionlosermovestothetopofthependingbracketqueue,anLUSTATcodex'00010000'issenttonotifytheapplicationthatthephysicalprinterisnowavailable.
UsingVirtualPrintersToimplementavirtualprinter,youmustperformthefollowingsteps:1.
DefinethevirtualprinterasanACBinamajornodeinSYS1.
VTAMLST(newname).
UsetheACQparametertogivetheACBacquireauthority.
CT/Enginepassesalldatatothephysicalprinterunchanged.
Forthisreason,thedevicecharacteristicsofthevirtualandphysicalprintersmustbeidentical.
YoumightneedtospecifytheDLOGMODparameteronthevirtualprinterAPPLstatementinSYS1.
VTAMLST(newname)toensurepropercoordinationCopyrightIBMCorp.
1997,201533withthephysicalprinter'scharacteristics.
ItisrecommendedtousethelogmodeDSC2KforSNAprintersandS3270fornon-SNAprinters.
Forexample,ACB16APPLAUTH=(ACQ,NVPACE),ACBNAME=ACB16,PARSESS=YES,DLOGMOD=DSC2KorACB16APPLAUTH=(ACQ,NVPACE),ACBNAME=ACB16,PARSESS=YES,DLOGMOD=S32702.
IssuetheVPRINTERcommand,eitherfromthestartupcommandlist,&rhilev.
RLSCMDS(KLSSTART),orasanoperatorcommand.
TheVPRINTERcommandopenstheACBandassociatesthevirtualprinterwiththephysicalprinter.
Forexample,VPRINTERACB16SYSOUTCLASS=SDEST=RMT5FordetailedinformationontheVPRINTERcommand,seetheOperator'sGuide.
Nowyouruserssimplyspecifyavirtualprinternameinsteadofaphysicalprinternamewhentheyprint.
OryoucanlettheNAMdatabaseortheapplicationselectthevirtualprinter,makingtheselectiontransparenttotheuser.
SeeChapter10,"NetworkAccessManager,"onpage105.
OnceyouissuetheVPRINTERcommand,itopenstheACB.
AnyofthefollowingactionsclosesthevirtualprinterACB:vissuingtheCLOSEcommandvshuttingdownCT/EnginevissuingtheVTAMVARYINACTcommandIfyouaregoingtousevirtualprintersfrequently,youwillprobablywanttoaddtheVPRINTERcommandsasthelastfewlinesinyourstartupmember.
UsingVPRINTERwhenPrintingSessionScreensIfyouwillbeprintingsessionscreenswhileusingtheVPRINTERfunction,youmustbecertainthatthevirtualprinterACBandthedialogACBthatisusingthevirtualprinter(forexample,theCL/SuperSessionACB)arebothdefinedinVTAMLSTAPPLsasparallel-session-capable(PARSESS=YESontheAPPLstatement).
Forexample,ACB16APPLAUTH=(ACQ,NVPACE),ACBNAME=ACB16,PARSESS=YES,DLOGMOD=DSC2KWhenVPRINTERiswaitingforthephysicalprinter,manyactiveVSSPRINTsessionsfromthedialogACBtothevirtualprinterACBmustbesustained.
Ifthetwoapplicationsarenotparallel-session-capable,thefirstVSSPRINTwillgetasessionandanysubsequentVSSPRINTsessionrequestswillfailwithRC20.
Thedistributed@ptriggercanalsobeusedtoroutesessionscreenstoVTAMprinters.
SeetheUser'sGuideforinformationoninvokingthistrigger.
FormoreinformationontheVSSPRINTstatement,seetheDialogLanguageReferenceManual.
FormoreinformationontheVPRINTERcommand,seetheOperator'sGuide.
UsingVirtualPrinters34IBMCL/SuperSessionforz/OSCustomizationGuideUsingVirtualPrintersinPortContentionEnvironmentsPortcontentioncausesthenetworkname(LUname)assignedtoaphysicalterminalorprintertobeunpredictable.
However,manyapplicationsdependontheterminalnetworknamesbothforsecurityandforacquiringprinters.
Portcontentioncanbecausedbyanyofthefollowing:vValueaddednetworks,suchasIINorTYMNETvProtocolconverters,suchas3708svLocalareanetworks(LANs)vX.
25Althoughvirtualterminalpoolingdoesnotcausephysicalportcontention,itdoescreatethesametypesofproblemsforapplicationsthatdependonthephysicalterminalname.
ThefollowingexamplesprovidesolutionstoIINportcontentionproblemsforCL/SuperSessionusers.
Note:Theseexamplesmayrequireadditionalcustomizationforparticularcustomerneedsorenvironments.
CL/SuperSessionExample1.
DefineallnecessaryvirtualterminalsasAPPLstoVTAM,ifyouhavenotalreadydoneso.
2.
CreatedialogsIINPRTandIINPRTRin&rhilev.
RLSPNLS,asshowninFigure10onpage36andFigure11onpage37.
IINPRTisaprofileinitialdialogthatcallsIINPRTRtodeterminetheIINprintername.
UsingVirtualPrintersinPortContentionEnvironmentsChapter4.
VirtualPrinters35)commentName:IINPRTTobeusedasaprofileinitialdialog.
ThisdialogstartstheappropiateVPRINTERbasedupontheuser'sID.
)optionlevel(1))declarevspprtscope(session)viguserscope(session)iinuidscope(local)lscope(local)oscope(local)vprtscope(local))initIf'&substr(&systerm,0,3)'ne'IBM'/*isitanIINuser*/returnsetiinuid&viguser)prologuesetl'&length(&iinuid)'/*actuallengthoftheUSERID*/seto&l-1/*settheoffsettothelastchar*/if&vspprt/*GettheusersdefaultVPRINTERname*/setvprt&vspprt/*fromthePROFILEsetting*/else/*OR*/setvprt'&substr(&iinuid,0,&l)P'/*AddaPtotheUSERID*/COMMAND('as''*SYSVLG*''CLOSE&vprt')wait(1)/*letitclose*/dialogIINPRTR/*establishtheactualIINprintername*/If&sysrcdoCOMMAND('as''*SYSVLG*''VPRINTER&vprt&sysrc')returnenddialogklsmsgbl'ERROR,R,P,The&vprtwasnotstarted'Figure10.
CL/SuperSessionIINPRTDialogUsingVirtualPrintersinPortContentionEnvironments36IBMCL/SuperSessionforz/OSCustomizationGuideCL/SuperSession-OnlyExampleInaCL/SuperSession-onlyconnectionthroughIINthefollowingprocedurecanbeused.
SpecifythePRTPOOLoperandandPRINTER=REQUIREDontheAPPLDEFasshowninthefollowingexample.
1.
DefineallnecessaryvirtualterminalsasAPPLstoVTAM,ifyouhavenotalreadydoneso.
2.
Addthefollowingto&rhilev.
RLSCMDS(KLGCAPLS):APPLDEFCICSdest=applid.
.
.
-PRTPOOL='*'PRINTER=REQUIRED3.
Inthe&rhilev.
RLSPARMGATEWAYconfiguration,specifythefollowing:PRTNODEREQUIRED)commentName:IINPRTR(calledbyIINPRT)ThisdialogdeterminestheIINprinternameassignedbaseduponthenameassignedfortheIINterminal.
)optionlevel(1))declareiintrmscope(local)iinprtscope(local)lscope(local)oscope(local)lcscope(local)acscope(local))initsetiintrm&systerm/*SYSTERMalwayshaslengthof8*/)prologuesetl'&length(&iintrm)'/*actuallengthoftheterminalID*/seto&l-2/*settheoffsettothe2ndtolastchar*/if'&substr(&iintrm,&o,1)'eq'J'/*isthe7thcharaJ*/dosetprt1'&substr(&iintrm,0,&o)K'/*thentheprinterhasaK*/setprt2'&substr(&iintrm,&l-1,1)'setiinprt'&prt1&prt2'return&iinprtendelse/*ifNOT.
.
.
.
*/doseto&o+1/*resetoffsettothelastchar*/setlc'1'/*Startingpoint*/setac'A'endDOif'&substr(&iintrm,&o,1)'eq&lc/*Checkthelastchar*/dosetiinprt'&substr(&iintrm,0,&o)&ac'/*set1thru9*/Return&iinprt/*to*/end/*AthruI*/setlc&lc+1setac(eval'&&sysincr(&ac)')UNTIL&lcgt9LOG('PRT=&iinprtlc=&lcac=&acl=&lo=&oTRM=&iintrm')/*logthevalues*/exit/*notanIINterminal*/Figure11.
CL/SuperSessionIINPRTRDialogUsingVirtualPrintersinPortContentionEnvironmentsChapter4.
VirtualPrinters37PANEL(IINPRTR)PRTPOOLREQUIREDDEFAULT(VPRTP)4.
Addthefollowingto&rhilev.
RLSCMDS(KLS$VSMS):VSMDEFVPRTPVPRT00TH(5)DEFER-Logmode(&deflmode)5.
CreatetheIINPRTRdialogin&rhilev.
RLSPNLSasshowninFigure12onpage39.
Asessionisautomaticallyestablishedbetweenthegatewayelements&VIGPRTPL(PRTPOOL)and&VIGPNODE(PRTNODE).
UsingVirtualPrintersinPortContentionEnvironments38IBMCL/SuperSessionforz/OSCustomizationGuideChapter5.
CL/SuperSessionCustomizationThischapterexplainsthegatewayconfigurationandshowshowtocustomizeCL/SuperSession.
Youwilllearnhowto:vSetCL/SuperSessioninitializationparametersvDefineanetworkentrypoint)commentName:IINPRTRThisdialogdeterminestheIINPRINTERnameassignedbaseduponthenameassignedfortheIINTERMINAL.
)optionlevel(1))declareiintrmscope(local)iinprtscope(local)lscope(local)oscope(local)lcscope(local)acscope(local))initsetiintrm&systerm/*SYSTERMalwayshaslengthof8*/)prologuesetl'&length(&iintrm)'/*actuallengthoftheterminalID*/seto&l-2/*settheoffsettothe2ndtolastchar*/if'&substr(&iintrm,&o,1)'eq'J'/*isthe7thcharaJ*/dosetprt1'&substr(&iintrm,0,&o)K'/*thentheprinterhasaK*/setprt2'&substr(&iintrm,&l-1,1)'setiinprt'&prt1&prt2'setvigpnode'&iinprt'returnendelse/*ifNOT.
.
.
.
*/doseto&o+1/*resetoffsettothelastchar*/setlc'1'/*Startingpoint*/setac'A'endDOif'&substr(&iintrm,&o,1)'eq&lc/*Checkthelastchar*/dosetiinprt'&substr(&iintrm,0,&o)&ac'/*set1thru9*/setvigpnode'&iinprt'Return/*to*/end/*AthruI*/setlc&lc+1setac(eval'&&sysincr(&ac)')UNTIL&lcgt9LOG('PRT=&iinprtlc=&lcac=&acl=&lo=&oTRM=&iintrm')/*logthevalues*/setvigpnode'DEFPRINT'/*topreventelementresolutionloop*/exit/*notanIINterminal*/Figure12.
CL/SuperSessionIINPRTRDialogCopyrightIBMCorp.
1997,201539vSpecifyagatewaydatadefinitionvCustomizemessagesvDefineapplicationsvCreateauthorizedapplicationlistsvCustomizethenetworkbroadcastfacilityvCustomizethenewsfacilitySettingCL/SuperSessionInitializationParametersDuringinitialization,&rhilev.
RLSPARM(KLGINGWY)providesdefaultvaluesforcertainglobalCL/SuperSessionparameters.
TheseparameterstakeeffectforallgatewaysinthesameCT/Engineaddressspace.
TheformatoftheKLGINGWYparametersisshownbelow.
Allparametersmustbeprovidedasasinglelogicalstatement.
[BCGROUP=bcgroup][MONITOR=interval|5:00]BCGROUPIdentifiesthebroadcastgroupassignedtoauserwhenamorespecificbroadcastgroupnamecannotbeacquiredfromanauthorizedapplicationlist(APPLIST)oragatewaydefault.
IfBCGROUPisomitted,aglobalbroadcastgroupisnotdefined.
MONITORDefinestheintervalthatoccursbetweenapplicationstatustests.
Whentheintervalexpires,eachapplicationdefinedinanAPPLDEFstatementisinterrogatedbyVTAMINQUIRE.
Thestatusreturnedisretainedfordisplayonthemenu.
Specifytheintervalasadecimalnumberindicatingthelengthoftimeinseconds,orashh:mm:ss.
Iftheintervalisspecifiedaszero,nostatusinquirytakesplace.
Thedefaultvalueis5minutes.
Ifyousettheintervaltoasmallervalue,networkperformancemaysuffer.
TheMONITORinitializationparameteriscompletelyunrelatedtotheMONITORoperatorcommand,whichcontrolsmessagetypes.
ForinformationontheMONITORcommand,seetheOperator'sGuide.
DefiningaNetworkEntryPointTheHOSTGATEcommanddefinesanetworkentrypoint,orgatewaythatcontrolsentryintotheVTAMnetwork.
EachgatewayisassociatedwithanapplicationimplicitlyorexplicitlyselectedbyCL/SuperSessionusersenteringthenetwork.
YoucanuseHOSTGATEtodefinemorethanonegateway.
&rhilev.
RLSCMDS(KLGCHGGW)definesthreedefaultgateways:KLGICFG1,KLGICFG2,andKLGICFG3(membersinlibrary&rhilev.
RLSPARM).
ThesegatewaysareinitiallyopenedbytheirVTAMACBnamesKLSGW001,KLSGW002,andKLSGW003,asshownbelow.
HOSTGATEKLSGW001CONFIG=KLGICFG1BCGROUP=GROUP1DIALOG=KLGATEWYATTENTION=KLSPG08HOSTGATEKLSGW002CONFIG=KLGICFG2BCGROUP=GROUP2DIALOG=KLGATEWYATTENTION=KLSPG08HOSTGATEKLSGW003CONFIG=KLGICFG3BCGROUP=GROUP2DIALOG=KLGATEWYKLGICFG1requiresuserIDandpasswordvalidationforaccesstotheMainMenu.
CL/SuperSessionCustomization40IBMCL/SuperSessionforz/OSCustomizationGuideKLGICFG2presentsthemenudirectlytotheuser,withoutIDandpasswordvalidation.
KLGICFG3connectstheuserdirectlytotheCT/Engineoperatorfacility.
NotriggersorCT/Enginefunctions,suchasATTN,areavailablethroughKLGICFG3unlessthesinglesessionisaMULTI-type.
YoucanuseHOSTGATEcommandstodefineadditionalgateways,whichcanbesetupinnewconfigurationmembersin&rhilev.
RLSPARM.
Forexample,youmightwantonegatewaytoprocessallin-houseterminalsattachedtodedicatedlines,andanothertocontrolallterminalsconnectedbyapublicdatanetwork.
Eachgatewaycandefineuniquepanels,securityvalidationtechniques,andauthorizedapplicationlists.
YoucanusetheAPPLDEFcommandtodefineagatewayasanapplication.
Toconnectseparatehostsornetworks,defineHOSTGATEcommandsineachhostornetwork.
ThePASSdialogfunctioncanpass(VTAMCLSDSTPASS)aphysicalorvirtualterminaltoaHOSTGATEonanyhostconnectedbycross-domainorcross-networkfacilities.
HOSTGATEcommandsarenormallyfoundin&rhilev.
RLSCMDS(KLGCHGGW).
Thisensuresthatallgatewaysareavailabletousersimmediatelyafternetworkstartup.
YoucanalsoissueHOSTGATEcommandsfromtheCT/EngineoperatorfacilitytoaddnewgatewayswithoutrecyclingtheCT/Engineaddressspace.
Ifagatewayconfigurationneedstochangewhiletheproductisrunning,implementthenewconfigurationasfollows:1.
UsetheCT/EngineCLOSEcommandtoshutdownthegateway.
FortheCLOSEoperand,specifytheACBnameofthegatewaytobestopped.
2.
IssueaHOSTGATEcommandtorestartthegatewaywiththenewconfiguration.
FordetailedinformationontheHOSTGATEcommand,seetheOperator'sGuide.
GatewayConfigurationEachgatewayisdefinedbyanumberofpredefineddataitems,calleddataelements.
Dataelementsidentifytheuser,handletheapplicationselectionprocess,andcontrolanumberofothersessionservices.
Thevalueassociatedwithadataelementmaybederivedfromavarietyofmechanisms,ordatasources.
Adatasourceidentifiesafacility,suchasapaneloraresolutionroutine,thatacquiresadataelementvalue.
Thecollectionofdataelementsandassociateddatasourcesiscalledgatewayconfiguration.
Agatewayconfigurationconsistsofaseriesofentries,eachcontainingthenameofadataelementfollowedbyalistofoneormorecandidatedatasources.
Figure13onpage42showstheformatofadatadefinitioninagatewayconfigurationmember.
DefiningaNetworkEntryPointChapter5.
CL/SuperSessionCustomization41Whenseveraldatasourcesarespecifiedforasingledataelement,thecandidatesareexaminedinturnuntilavalueisacquired.
Thesequenceinwhichcandidatedatasourcesareexaminediscalledtheacquisitionsequence.
DialogKLGDRESinlibrary&thilev.
TLSPNLSresolvesthedataelements.
Thegatewayconfigurationmemberisalsothesourceforthemessagespresentedduringthelogonandapplicationselectiondialogs.
Whenanapplicationselectionerrororotherexceptionalconditionisencountered,theappropriatemessageappearsontheuser'sscreen.
Figure14onpage43showsanexampleofagatewayconfigurationmember,consistingofdatadefinitionsandmessages.
dataelement[USERDATA(position|keyword)][NAM][PANEL(panel)][DISPLAY][LIMIT(n)][PROMPT('string')][VARIABLE(varname)][EXIT(lmodname)][EXAMINE][DEFAULT(value)][OPTIONAL|REQUIRED|STATIC]Figure13.
DataDefinitionFormatGatewayConfiguration42IBMCL/SuperSessionforz/OSCustomizationGuideUSERID-REQUIRED-USERDATA(0)-PANEL(KLGLGON)-PROMPT('ENTERUSERID')-PASSWORD-REQUIRED-USERDATA(1)-PANEL(KLGLGON)-PROMPT('ENTERPASSWORD')-LIMIT(3)-NEWPSWD-REQUIRED-USERDATA(NEWPSWD)-PANEL(KLGLGON)-PROMPT('PASSWORDEXPIRED,ENTERNEWPASSWORD')ACCOUNT-OPTIONAL-PANEL(KLGLGON)-PROCOPTIONAL-PANEL(KLGLGON)-GROUPOPTIONAL-PANEL(KLGLGON)-APPLISTOPTIONAL-DEFAULT(&VSPAPLST)-DEST-REQUIRED-USERDATA(SESSID)-PANEL(KLSVSEL)-PROMPT('')-MENU-HELP(KLGWDEST)-LTERM-USERDATA(LTERM)-PANEL(KL1PGC9)-PROMPT('ENTERLTERM')-HELP(KLGWLTRM)-DEFAULT(&VIGUSER)-LOGMODE-OPTIONAL-POOL-DEFAULT(&DEFPOOL)-PRTLTERM-PANEL(KLGDIMS)-PROMPT('ENTERPRINTERLTERM')-PRTNODE-NAM-Figure14.
GatewayConfigurationMemberGatewayConfigurationChapter5.
CL/SuperSessionCustomization43DataElementsDataelementsprovidethebasisforthegateway'sdecisions.
Eachdataelementeitheridentifiestheuserorconveysapplicationselectionandsessionestablishmentcriteria.
Forexample,inFigure14onpage43,theUSERID,PASSWORD,andNEWPSWDdataelementsidentifytheuser,currentpassword,andnewpassword,respectively.
Onceavalueisobtainedforeach,thegatewaycanperformnetworkaccesssecurityvalidation.
Therecommendationreturnedbythesecuritysystemdetermineswhethernetworkaccessispermitted.
DataElementModifiersForeachdataelement,youcanspecifyoneofthefollowingmodifierstodeterminehowthegatewayconfigurationprocessesthedataelement:OPTIONALThegatewaydoesnotrequirethatthedataelementberesolved,eventhoughitisspecifiedaspartofthegatewayconfiguration.
REQUIREDResolution(i.
e.
,dialogKLGDRES)willnotreturnwithoutavalueforthedataelement.
Anerrorconditionwilloccurifnoneofthedatasourcesprovidesavalueforthedataelement.
STATICThegatewayacquiresavalueforadataelementonceonly.
ThismodifierisintendedforthePANELdatasource,topreventapanelfrombeingdisplayedmorethanoncetoacquireavalueforthedataelement.
WhenyouspecifySTATICforaPANELdatasource,thegatewayattemptstoacquirethedataelementfromthepaneluntiltheLIMITthresholdisreached.
Oncethedataelementisacquired,thegatewayneverattemptstoacquirethedataelementagainforthecurrentgatewaysession.
Ifyoudonotenteramodifier,eachdataelementspecifiedintheconfigurationisassignedadefaultmodifier.
However,basedonotherparametersinthegatewayconfiguration,thedefaultmaychangefromonegatewaytoanother.
Thedataelementsarelistedbelowinalphabeticalorder.
ACCOUNTSpecifiesthesiteaccountnumberassignedtotheuser.
TheNetworkAccessManager(NAM)passestheACCOUNTdataelementtoasecuritysystemortotheNAMuserexit.
Althoughthegatewaydoesnotenforcespecialformattingrequirements,theformatoftheaccountnumbershouldbethesameasrequiredbyz/OSoryoursecuritysystem.
ThedefaultmodifierforACCOUNTisOPTIONAL.
APPLISTIdentifiesanauthorizedapplicationlistmaintainedin&thilev.
TLSPARM(forexample,KLGIAPL1).
Ifspecified,thismemberidentifiesthesubsetofnetworkapplicationsavailabletotheuser.
DESTIdentifiestheselectedapplication.
ItmustcorrespondtothesessionIDidentifiedintheDESTparameterofanAPPLDEFcommand.
ThegatewaysthatallowtheusertoselectanapplicationfromamenugenerallyobtainDESTfromthePANELdatasourceduringanapplicationselectiondialog.
DataElements44IBMCL/SuperSessionforz/OSCustomizationGuideAdestinationnameisalwaysrequired.
IfDESTisomitted,itisassumedtobethefirsttokenoftheuserdatastring.
ThedefaultmodifierforDESTisREQUIRED.
SinceDESTmustbeacquiredwhenitisdefinedaspartoftheconfiguration,aspecificationofOPTIONALisinvalid.
InordertoproperlyresolvetheDESTdataelement,theKLGICFG3configurationmemberinyour&rhilev.
RLSPARMrequiresoneofthefollowing:vPANEL(KLGDST)vpanelwithsimilarlogic,asdescribedinthecommentsofdialogKLGDSTGROUPIdentifiesthegroupassignedtotheuser.
TheNAMfacilitypassestheGROUPdataelementtoasecuritysystemortotheNAMuserexit.
Althoughthegatewaydoesnotenforcespecialformattingrequirements,theformatofthegroupnameshouldbethesameasrequiredbyz/OSoryoursecuritysystem.
ThedefaultmodifierforGROUPisOPTIONAL.
LOGMODESpecifiestheVTAMlogmodetableentrynametobeusedinestablishingasessionbetweentheuserandtheapplication.
Ifspecified,theLOGMODEdataelementoverridesanylogmodevaluedesignatedinthegatewayvirtualterminalpoolortheVTAMAPPLstatement.
ThedefaultmodifierforLOGMODEisOPTIONAL.
LTERMIdentifiestheIMS/DClogicalterminal(LTERM)nametobeassociatedwiththeuserrequestingaccesstoanIMS/DCsubsystem.
ThedefaultmodifierforLTERMisREQUIREDwhenevertheIMSuserLTERMassignmentsessionserviceisused.
Inthiscase,aspecificationofOPTIONALwillproduceanerrorifavalueforLTERMisnotacquired.
NEWPSWDSuppliesa1-to8-characterstringconsistingofauser'snewpassword.
Ifprovided,thevalueofNEWPSWDreplacesthevalueofPASSWORDuponsuccessfulvalidationofthecurrentUSERIDandPASSWORD.
IfNEWPSWDisnotdefined,thegatewaycannotperformPASSWORDmaintenance.
ThedefaultmodifierforNEWPSWDisOPTIONAL.
PASSWORDSuppliesa1-to8-characterstringconsistingofapersonalidentificationcodeusedtoconfirmtheidentityoftheuserspecifiedbytheUSERIDdataelement.
ThedefaultmodifierforPASSWORDisREQUIRED.
POOLSpecifiesavirtualterminalpoolusedtoformavirtualsessionbetweentheuserandtheapplication.
ThenameofthedesiredterminalpoolisusuallyspecifiedintheAPPLDEFstatementidentifyingtheapplication.
However,thePOOLdataelementprovidesanalternatemethodforallowingdynamicselectionofavirtualterminalpoolonthebasisoftheuser'sterminalcharacteristicsorotherspecifiedcriteria.
IfyouusethePOOLdataelementtoselectapooldynamically,youmustincludePOOL='*'orPOOL='&DEFPOOL'intheAPPLDEFstatement.
DataElementsChapter5.
CL/SuperSessionCustomization45ThedefaultmodifierforPOOLisREQUIRED.
SincethisdataelementisresolvedonlyifPOOL='*'orPOOL='&DEFPOOL'isincludedintheAPPLDEF,OPTIONALshouldneverbespecified.
PROCSpecifiesavalidTSOlogonprocedure.
ThePROCdataelementispassedtotheNAMuserexit.
Althoughthegatewaydoesnotenforcespecialformattingrequirements,theformatofthelogonprocedurenameshouldbethesameasrequiredbyz/OS.
ThedefaultmodifierforPROCisOPTIONAL.
PRTLGMODSpecifiestheVTAMlogmodetableentrynametobeusedinestablishingasessionbetweentheuserandaphysicalprinter.
PRTLGMODoverridesthelogmodespecifiedintheVTAMdefinitionfortheprinterlogicalunit.
ThedefaultmodifierisOPTIONAL.
PRTLTERMIdentifiesanIMS/DCprinterterminalLTERMassociatedwiththeuserrequestingaccesstoanIMS/DCsubsystem.
ThedefaultmodifierforPRTLTERMisREQUIREDwhenevertheIMSuserLTERMassignmentsessionserviceisrequestedandthePRTNODEdataelementisincludedintheconfiguration.
Inthiscase,aspecificationofOPTIONALwillproduceanerrorifavalueforPRTLTERMisnotacquired.
PRTNODEIdentifiestheprinterterminallogicalunitassociatedwiththeuserorterminalaccessinganapplication.
Itmaybespecifiedforanyapplicationthatusesvirtualprinterterminalpooling.
ThedefaultmodifierforPRTNODEisREQUIREDwhenevertheIMSSessionCleanuporUserLTERMAssignmentsessionserviceisappliedtoboththeuser'sterminalandanassociatedprinterterminal.
Inthiscase,aspecificationofOPTIONALwillproduceanerrorifavalueforPRTNODEisnotacquired.
ThePRINTERoperandontheAPPLDEFcommandmustbesettoOPTIONALorREQUIREDforresolutiontooccur.
Iftheoperandisnotspecified,PRTLTERMresolutionwillnotbedriven.
PRTPOOLIdentifiesavirtualprinterpoolusedtoformavirtualsessionbetweentheuserandtheapplication.
ThenameofthedesiredprinterpoolisusuallyspecifiedintheAPPLDEFstatementidentifyingtheapplication.
However,thePRTPOOLdataelementprovidesanalternatemethodforallowingdynamicselectionofavirtualprinterpoolonthebasisoftheuser'ssessioncharacteristicsorothercriteria.
IfyouusethePRTPOOLdataelementtoselectaterminaldynamically,youmustincludePRTPOOL='*'orPRTPOOL='&DEFPOOL'intheAPPLDEFstatement.
ThedefaultmodifierforPRTPOOLisREQUIRED.
SincethisdataelementisresolvedonlyifPRTPOOL='*'orPRTPOOL='&DEFPOOL'isincludedintheAPPLDEF,OPTIONALshouldneverbespecified.
USERDATAContainsanapplication-dependentcharacterstringthatispassedtotheapplicationwhenasessionisestablishedwiththeuser.
DefinedUSERDATAdataelementsconsistingofnullsorblanksarenotsenttotheapplication.
USERDATAcanalsoidentifythenameofthedestinationapplicationwhentheDESTdataelementisnotdefined.
Inthiscase,thefirsttokenintheuserdatastringisassumedtocontaintheDataElements46IBMCL/SuperSessionforz/OSCustomizationGuideapplicationname.
Theremainderofthestringissenttotheapplicationasuserdata.
YoucanalsospecifyUSERDATAinanAPPLDEFcommand.
Ifyoudoso,theUSERDATAspecifiedinAPPLDEFoverridestheUSERDATAdataelement.
ThedefaultmodifierforUSERDATAisOPTIONAL.
However,iftheDESTdataelementisnotdefinedintheconfiguration,theUSERDATAdataelementmustbedefined.
Inthatcase,thedefaultmodifierisREQUIRED.
USERIDSuppliesa1-to8-characterstringthatuniquelyidentifiestheuser.
USERIDandPASSWORDareusedincombinationtoprovidethebasisforthenetworkaccessauthorizationvalidationsupportedbyCL/SuperSessionandbyexternalsecuritysystems,includingRACF,CA-ACF2,andCA-TOPSECRET.
Typically,theUSERID,PASSWORD,andNEWPSWDdataelementsareobtainedfromagatewaylogonorapplicationselectiondialog.
Thatis,thePANELdatasourceisusuallyspecifiedforthosedataelements.
However,whenthegatewayisusedinatransparentmodewithoutanapplicationselectiondialog,theseelementscanbepassedtothegatewayasuserdatatoprovidenetworkaccesssecurityoreliminateredundantlogonsequencesintheaccessedapplication.
WhenNAMisspecifiedasadatasourceforanydataelement(suchasAPPLISTorLTERM),theUSERIDdataelementidentifiesthemajorkeyofthedesireddataelementvariable.
Thatis,USERIDisthekeyforNAMlookupsforanydataelementNAMresolves.
ThedefaultmodifierforUSERIDisREQUIRED.
DataSourcesAdatasourceistheplacewherethegatewaysearchesforadataelement.
Eachdatasourceidentifiesafacility,suchastheNAMdatabaseoradialogpanel,thatisresponsibleforacquiringadataelementvalue.
Severaldatasourcesmaybedesignatedforasingledataelement.
Whenseveraldatasourcesarespecified,theyareexaminedinapredefinedordertoacquirethedataelementvalue.
Thissequenceiscalledtheresolutionsequence.
Whenadatasourceisnotspecifiedforadataelement,thedatasourceisnotexamined.
Thedatasourcesarelistedhereinresolutionsequenceorder.
USERDATA(position|keyword)SpecifiesthatthedataelementmaybeincludedintheuserdatastringpassedtothegatewaybyVTAM.
AUSERDATAparameteridentifiesthemannerinwhichthedataelementisextractedfromtheuserdatastring.
NAMSpecifiesthatthedataelementistobeextractedfromtheNAMdatabaserecordidentifiedbytheUSERIDdataelement.
TheNAMdatasourcecanbeusedonlywhenaNAMdatabasehasbeenallocatedandloadedwithuserrecords.
Inaddition,NAMmaybespecifiedonlyfordataelementsmaintainedinNAMrecords.
PANEL(panel)Specifiesadialogpaneldefinitionthatmaybeusedtoobtainavalueforthedataelement.
Anamedmemberofthepanellibraryisinvokedandisresponsibleforsettingtheappropriatevariable.
Notethatapaneldoesnothavetobeinteractive;i.
e.
,itcanrunthedialogandquit.
IftheDISPLAYDataElementsChapter5.
CL/SuperSessionCustomization47datasourcequalifierisincluded,thedialogroutinecaninspectandreplaceadataelementvaluepreviouslyobtainedfromanotherdatasource.
Severaldataelementsmaybeacquiredconcurrentlyfromthesamepanel.
Caution:ThemembernamespecifiedshouldomittheNationalLanguagesuffix;e.
g.
,useKLGLGON,notKLGLGON1.
EXIT(lmodname)Identifiesanexitroutinethatmaybeinvokedtoderiveavalueforthedataelement.
IftheEXAMINEdatasourcequalifierisincluded,theexitroutinecaninspectandreplaceadataelementvaluepreviouslyobtainedfromanotherdatasource.
DEFAULT(value)Identifiesadefaultvaluethatisassignedtothedataelementwhennootherspecifieddatasourcecanproduceanappropriatevalue.
Whenusedalone,theDEFAULTdatasourceperformsanunconditionalassignmentofavaluetoadataelement.
USERDATADataSourceTheUSERDATAdatasourceindicatesthatauserdatastringpassedtothegatewaymaycontainavalueforagivendataelement.
TheUSERDATAoperandindicateseithertherelativepositionofthedataelementvalue,oridentifiesakeywordfromwhichtheappropriatevaluecanbeextracted.
Intherelativepositionformat,theUSERDATAoperandisspecifiedasadecimalnumber.
Thetokenfoundintheuserdatastringatthezero-relativepositionisextractedandassignedtothedataelement.
Iftheuserdatastringisnullorcontainsfewertokensthanrequired,novalueassignmentismade.
ThisformatisfrequentlyusedwhenCL/SuperSessionisoperatingintransparentmode,particularlywhenanotherlogonsolicitorisinuseorwhencontrolispassedfromonegatewaytoanother.
DataobtainedfromthelogonsolicitororotherVTAMapplicationmaybeconvenientlypassedtothegatewaythroughaseriesofuserdatatokensarrangedinapredefinedsequence.
Inthekeywordformat,theUSERDATAoperandisspecifiedasacharacterstringthatcorrespondstoakeywordoccurringintheuserdatastring.
Whenlocated,thevalueassociatedwiththekeywordisassignedtothedataelement.
Iftheuserdatastringisnullordoesnotcontainthespecifiedkeyword,novalueassignmentismade.
Thisformatcanprovideaquicklogoncapability,bypassingthelogonandapplicationselectiondialogs.
Iftheuserisabletosatisfyalldataelementrequirementsbyincludingthespecifiedkeywordsinthelogonuserdatastring,noadditionalpromptingneedoccur.
Inthefirsttwodatadefinitionstatementsshownintheexamplebelow,theUSERIDandPASSWORDdataelementsmaybesuppliedtothegatewayasthefirstandsecondtokensoccurringintheuserdatastring.
Ifauserdatastringisnotfurnished,bothdataelementsmustbeacquiredfromotherdatasources.
TheDESTstatementillustratesthemannerthroughwhichakeywordintheuserdatastringcanbedefined.
Ifpresent,thevalueassociatedwiththeSENDTOkeywordisassignedtotheDESTdataelement.
Ifauserdatastringisnotfurnished,DESTmustbeacquiredfromanotherdatasource.
USERIDUSERDATA(0)USERIDCOMESFIRSTPASSWORDUSERDATA(1)FOLLOWEDBYPASSWORD*DESTUSERDATA('SENDTO')EXTRACTSENDTO=destDataSources48IBMCL/SuperSessionforz/OSCustomizationGuideNAMDataSourceYoucanuseNAManditsdatabasetoenrollauthorizednetworkusers.
TheNAMdatabasecanperformbasicsecurityfunctionsthatarenotprovidedbyanexternalsecuritysystem.
NAMrecordsalsoprovideaconvenientmeansofassociatingavarietyofdataelementsdirectlytoanindividualuserorphysicalterminal.
AlldataelementsexceptUSERIDmayberesolvedfromtheNAMdatabase.
FortheNAMdatabasetoresolvedataelements,theUSERIDdataelementmustbespecifiedinthegatewayconfigurationmember.
DataelementvaluesarestoredandretrievedintheNAMdatabaseusingthedataelementnameasthevariablename.
Intheexamplebelow,authorizedapplicationlistshavebeendefinedforasubsetofitsusers.
TheUSERIDisthefirstdataelementthegatewayobtains.
BecausetheAPPLISTdataelementspecifiestheNAMdatasource,NAMusestheUSERIDasthemajorkeyandthedataelementnameastheminorkeytoretrievetheappropriateuserrecordfromthedatabase.
TheAPPLISTmembernamecontainedintherecordisextractedandassignedtotheAPPLISTdataelement.
NotethattheNAMkeywordhasnooperands.
APPLISTNAM/*AUTHORIZEDAPPLICATIONLIST*/PANELDataSourceThePANELdatasourceprovidesamechanismforacquiringdataelementsdirectlyfromtheuser.
TheoperandofthePANELkeywordidentifiesthenameofapaneldefinitionresidinginthepanellibrary(&rhilev.
RLSPNLS).
Ifthedataelementhasnotalreadybeenresolvedandthedataelementisnotoptional,thepanelisinvoked.
Ifthedataelementisoptional,youcanforcedisplayofthepanelbyspecifyingDISPLAYinthedatadefinition.
Whenadialogisinvoked,itsetsthevariablesassociatedwiththedataelementsthatthepanelwilldisplayand/oracquire.
Table3showsthevariablenameassociatedwitheachdataelement.
Table3.
DataElementVariableNames.
DataElementVariableNameVariableScopeACCOUNTVIGACCTsessionAPPLISTVIGAPLSTsharedDESTVIGDESTsharedGROUPVIGGROUPsessionLOGMODEVIGLMODEsharedLTERMVIGLTERMsharedNEWPSWDVIGNPSWDsessionPASSWORDVIGPSWDsessionPOOLVIGPOOLsharedPROCVIGPROCsessionPRTLGMODVIGPRTLGsharedPRTLTERMVIGPLTRMsharedDataSourcesChapter5.
CL/SuperSessionCustomization49Table3.
DataElementVariableNames(continued).
DataElementVariableNameVariableScopePRTNODEVIGPNODEsharedPRTPOOLVIGPRTPLsharedUSERDATAVIGDATAsharedUSERIDVIGUSERsessionEachdataelementthatincludesthePANELdatasourcecanspecifyacommonpanelname.
Theusercanenterseveraldataelementsonthesamepaneldisplay.
Alternatively,adistinctpanelcanbeprovidedforeachdataelement.
Inthiscase,theuserispresentedwithaseriesofpaneldisplays,oneforeachdataelementthatrequiresresolution.
YoucanmodifytheoperationofthePANELdatasourcebyincludingoneormoreofthedatasourcemodifiersdescribedbelow.
DISPLAYSpecifiesthatthepanelusedtocollectthedataelementwillbedisplayedregardlessofwhetheravaluehasbeenacquiredfromanotherdatasource.
Ifavalueisassociatedwiththedataelement,itisalsopresented.
WhenDISPLAYisomitted,thepanelispresentedonlyifavaluehasnotalreadybeenacquiredforthedataelement.
TheDISPLAYkeywordhasnooperands.
LIMIT(n)Whenapanelispresentedtoacquireadataelementfromtheuser,thepanelisusuallyredisplayedwhentheelementisnotenteredcorrectly.
However,whentheuserperformsalogonsequenceinvolvingtheUSERIDandPASSWORDdataelements,itisdesirabletoestablishaceilingonthenumberoflogonattempts.
TheLIMITqualifiermaybeusedtospecifythemaximumnumberofattemptsallowed.
Ifthethresholdisexceeded,thesessionwiththegatewayuserisdropped.
SpecifytheLIMIToperandas0,1,2,or3.
Forexample:LIMIT(2)Everyattemptedresolution,whethervalidorinvalid,ofadataelementcountsagainsttheLIMITforthatdataelement.
NulldataalsocountsagainsttheLIMIT.
IfadataelementwithalowLIMITisresolvedbecauseoffailurestoresolveadataelementwithahigherLIMIT,thelogonisrejected.
PROMPT('string')Associatesaone-linepromptorotherdirectivewiththepaneldisplay.
Whenapanelispresentedtoresolveaspecificdataelement,thepromptisalsodisplayed.
ThelocationofthepromptisdeterminedbythepresenceoftheVIGMSGsessionvariable.
Specifythepromptasacharacterstringenclosedinquotes.
Forexample:PROMPT('Enterapplicationnamefrommenu')Somedataelementshavedefaultpromptsthatwillappearonthescreenifapromptisnotspecified.
Forexample,thedefaultpromptforUSERIDisDataSources50IBMCL/SuperSessionforz/OSCustomizationGuide'PLEASEENTERUSERID'Ifyoudonotwantaprompttoappearonyourusers'screens,enterblanksforthecharacterstring:PROMPT('')VARIABLE(varname)Reassignsthevariablenamethatrepresentsaspecificdataelementinapaneldefinition.
EachdataelementthatcanbeacquiredbythePANELdatasourceisassociatedwithadefaultvariablename.
Ifthesedefaultsarenotsuitable,youcanusetheVARIABLEqualifiertodefineanewvariable.
SpecifytheVARIABLEoperandasavariablenamenotlongerthan8characters.
Notethatthevariableprefixcharacter(&)isomitted.
Forexample:VARIABLE(MYDEST)EXITDataSourceTheEXITdatasourceextendsthedataelementresolutionprocesstoincludedatasourcesanddataacquisitiontechniquesthatyoudefine.
TheEXITkeywordincludesanoperandthatspecifiesthenameofthedataelementresolutionroutineyousupply.
YoucanmodifytheoperationoftheEXITdatasourcebyincludingtheEXAMINEqualifier.
EXAMINESpecifiesthattheresolutionroutineistobegivencontroltoexamineormodifythecorrespondingdataelement,regardlessofwhetheravaluehasbeenacquiredfromanotherdatasource.
WhenEXAMINEisomitted,theresolutionroutineisinvokedonlyifavaluehasnotalreadybeenacquired.
TheEXAMINEkeywordhasnooperands.
Anexampleofasite-writtenresolutionroutinecanbefoundin&thilev.
TLSSAMP(KLGXELEM).
Thesampleexitroutineillustratescodingguidelinesandhighlightsbasicconcepts.
KLGXELEMcallsTGMACLIB(KLG#GEPL),whichprovidesaparameterlistfortheexit.
Mostparametersinthelistpointtodataelementstoberesolvedduringtheexit.
ParameterPointstoAREAUserworkareaaddressSTRStringaddressSTRLNStringlengthPHYSNPhysicalnodenameVIRTNVirtualnodenameAPPLApplicationnameUSERUSERIDstringpointerAPLSTAPPLISTstringpointerPNODEPRTNODEstringpointerPLTRMPRTLTERMstringpointerDataSourcesChapter5.
CL/SuperSessionCustomization51ParameterPointstoLTERMLTERMstringpointerDESTDESTstringpointerLMODELOGMODEstringpointerDATAUSERDATAstringpointerPOOLPOOLstringpointerIBUSDInboundUSERDATAstringpointerGROUPGROUPstringpointerACCTACCOUNTstringpointerPROCPROCstringpointerDIALGDialogserviceAUBActiveuserblockSomeexitparameterspointtoalengthfollowedbythedata;theseincludeAPLST,DATA,DEST,IBUSD,LMODE,LTERM,PLTRM,PNODE,POOL,andUSER.
Otherexitparameterspointtoan8-characterstring(paddedwithblanksontheright,ifnecessary);theseincludeAPPL,PHYSN,andVIRTN.
Incodingyourownexitroutines,keepinmindthefollowingsequenceofdataelementresolution:vUSERIDisalwaysthefirstelementresolved.
vAPPLISTmustberesolvedbeforeDEST.
vDESTmustberesolvedbeforeLOGMODE,LTERM,POOL,PRTLTERM,PRTNODE,andUSERDATA.
YoucaninvokeKLV$$MACofTGMACLIBatthebeginningofanyexitandthenusethe$USREXITmacrotogetvariables,managememory,andusedialogservices.
Az/OSLOADcanalsobeperformedduringanexit,providedthereisenoughRESERVEspaceavailableintheaddressspace.
See"RESERVE"onpage151.
Intheexampleshownbelow,thesitehassuppliedaresolutionroutinefortheAPPLISTdataelement.
TheUSERDATAdatasourceindicatesthatanAPPLISTdesignationmayalsobeavailableintheuserdatastringpassedtothegateway.
TheEXAMINEqualifierallowstheresolutionroutinetoinspectand/orreplacetheAPPLISTname,eveniftheAPPLISTnamewasprovidedintheuserdatastring.
APPLISTUSERDATA('APPNAME')EXIT(APPEXIT)EXAMINEForanexampleofadestinationexit,see&rhilev.
RLSSAMP(KLSXMSGS).
DEFAULTDataSourceTheDEFAULTdatasourceprovidesavalueforadataelementwhennootherdatasourcehasbeendefined,orwhendefineddatasourceshavefailedtoresolvethedataelement.
TheDEFAULTdatasourceisexaminedlastintheresolutionsequence.
Therefore,allotherdatasourcesthatcansupplyavaluetakeprecedenceoverDEFAULT.
DataSources52IBMCL/SuperSessionforz/OSCustomizationGuideThevaluespecifiedintheDEFAULTkeywordoperandisassignedtothedataelementbeforeresolutionisattempted.
Therefore,ifEXITisspecified,theresolutionroutineobservesthedefaultvalueinthestoragecell.
Similarly,ifaPANELdatasourceisspecified,thepaneldisplayedpresentsthedefaultvalueforinspectionormodification.
Supposeweusethefollowingexample:DESTDEFAULT(SYSIMS)APPLISTNAMDEFAULT(DFTLIST)LTERMDEFAULT(&SYSTERM)Thefirstlineassignsadefaultvaluetothedestinationapplication(DEST).
Sincenootherdatasourceisdefined,theDESTdataelementisalwaysacquiredfromthespecifieddefaultvalue.
Inthisexample,theSYSIMSdestinationapplicationnameisassignedtotheDESTdataelementforeachusercomingthroughthegateway.
ThesecondlineselectstheDFTLISTauthorizedapplicationlistforallusersofthegateway,butonlyifaNAMrecordfortheAPPLISTcannotbeobtained.
ThethirdlinegivestotheLTERMdataelementthevalueofthevariable&SYSTERM.
The&SYSTERMvariableisthelogicalunitnameoftheterminal.
ThisexampledemonstratesasimplewayofassigninganLTERMbasedonthephysicalterminalname.
ResolutionSequenceThedialogsthatrunwhenaterminalsignson(beginningwithdialogKLGATEWY)resolve,(assignvaluesto)thevariousdataelements.
Thesequencebeginsbyresolvingthedataelementthatidentifiestheuser.
Itcontinuesbyexaminingdatasourcestoresolveinformationaboutthevariousselectionsmade.
TheKLGDRESdialogimplementstheresolutionsequencebyinvokingthedatasourcesdefinedinthegatewayconfigurationmembersKLGICFG1,KLGICFG2,andKLGICFG3of&rhilev.
RLSPARM.
Note:ItisnotrecommnededtochangetheKLGDRESdialog.
Thefollowinglistsummarizestheresolutionsequence:1.
USERDATAisinspected,ifitwassuppliedatlogon.
2.
IfinformationfromUSERDATAdidnotresolvethedataelement,NAMissearched.
3.
Panelsources(ifany)aresearchedifeitherofthefollowingapplies:vNeitherNAMnorUSERDATAsuppliedavalue.
vTheDISPLAYkeywordisspecifiedintheconfigurationmembertoforcepanelinvocation.
4.
TheEXITdatasourceisinspected.
AnEXITsourceisnotinvokedifavalueissuppliedbyanyofthepriorsources,unlesstheEXAMINEkeywordisincludedintheconfigurationmembertoforceEXITinvocation.
5.
Thedataelementissettothedefaultwhennootherdatasourcecanproduceavalue.
Table7liststhestandarddialogs,dataelements,andvariablenamesinvolvedintheresolutionprocess.
DataSourcesChapter5.
CL/SuperSessionCustomization53Table4.
DataElementResolution.
StandardDialogDataElementVariableNameKLGNTRYUSERIDVIGUSERKLGNTRYACCOUNTVIGACCTKLGNTRYGROUPVIGGROUPKLGNTRYPROCVIGPROCKLGNTRYNEWPSWDVIGNPSWDKLGNTRYPASSWORDVIGPSWDKLSUINI1APPLISTVIGAPLSTKLSCNTLDESTVIGDESTKLGSSHGUSERDATAVIGDATAKLGSSHGLOGMODEVIGLMODEKLGSSHGPOOLVIGPOOLKLGSSHGPRTNODEVIGPNODEKLGSSHGBRTPOOLVIGPRTPLKLGSSHGLTERMVIGLTERMKLGSSHGPRTLTERMVIGPLTRMKLGSSHGPRTLGMODVIGPRTLGWhenauserlogson(seeUserLogonProcess),theKLGATEWYdialogstarts.
KLGGW2callstheKLGNTRYdialog,whichprocessesthedataelementsconcernedwithuseridentificationandlogonprocedureinformation(seeTable6).
TheKLSPG00dialogthenissueseithertheVIGENTRYfunction,and/ortheVSSENTRYCL/SuperSessionfunction.
OneofthosefunctionsinvokestheKLSUINI1dialogastheinitializationdialogandKLSCNTLasthecontroldialog.
KLSUINI1setsupthenamesofthecommands,selectioncharacters,andstatuscodesfortheuser'senvironment.
Italsosetsupalistofalltheapplicationsthatauserisauthorizedtoaccess.
KLSUINI1resolvestheAPPLISTdataelement(seeTable6).
KLSCNTL(calledfromeitherVIGENTRYorVSSENTRYintheKLSPG00dialogafterKLSMP230completes)clearsouttheDESTdataelementsandcallstheKLGDRESdialogtoresolvethem.
IntheKLGICFG1configuration,KLGDREScallstheKLSVSELdialog,whichdisplaystheselectionmenu.
KLSVSEL1waitsforauseraction.
Whenaselectionismade,KLSCNTLcallsdialogKLGSSHG,whichcompletesthedataelementresolution.
CustomizingMessagesYoucancustomizethemessagesusersseeduringlogonandapplicationselectionbymodifyingthegatewayconfigurationmember.
Whenexceptionsaredetected,thegatewaygeneratesmessagenumbers.
Onceidentified,themessagenumberisusedtolocatethemessagetextdefinedbytheMESSAGEstatementintheconfigurationmember.
IfnoMESSAGEstatementisfoundtomatchthemessagenumber,adefaultmessageisprovided.
TheVIGMSGvariableisthenreplacedbythemessagetext,andthepanelisredisplayed.
ResolutionSequence54IBMCL/SuperSessionforz/OSCustomizationGuideHereistheformatoftheMESSAGEstatement:MESSAGEmsgnumber[msg_identifier|'msgtext']msgnumberThemessagenumberinternallyassociatedwithanexceptiondetectedbyagateway.
Adescriptionoftheexceptionsdefinedandtheassociatedmessagenumbersappearsbelow.
MsgnumberErrororexception00Anapplicationhasbeenselected,butthegatewayconfigurationhaschanged.
Theuserisgivenachancetorespecifyhisrequest.
01TherequestedapplicationdoesnotmatchanyauthorizedsessionIDdefinedinanapplicationdefinition(APPLDEF),orisnotincludedintheauthorizedapplicationlist(APPLIST)associatedwiththeuser.
02HELPwasrequested,butnoHELPisavailable.
TheHELPoperandcanbespecifiedintheAPPLDEFcommandthatdefinestheapplication,orintheconfigurationdefinitionforaspecificdataelement.
03Avaliddestinationwasselected,butthedestinationapplicationisinactiveorisnotacceptinglogonrequests.
04Anundefinedlogmodenamewasspecified.
Forvirtualsessions,makesuretheLOGMODEparameterontheVSMcommandspecifiesavalidentryname.
Ifthe&VIGLMODEproductvariableisbeingusedtosupplythelogmodename,makesureitcontainsthecorrectname.
05Thedestinationapplicationrejectedthesessionrequestbecausethelogicalunitwasnotknown.
Forexample,anattempttostartasessionwithIMSwillgeneratethismessageiftheLUnameofthephysicalterminalforCLSDSTPASSsessionsorthevirtualterminalforSINGLEsessionsdoesnotdefineavalidIMSPTERM.
06Thelogicalunitrejectedthesessionrequestbecauseofunsupportedsessionparameters.
Forexample,anattempttobinda3278model2withamodel3bindwillgeneratethismessage.
07Unabletoestablishavirtualterminalsession.
08ThevirtualterminalpoolspecifiedforaSINGLEsessionisempty.
09ThevirtualprinterpoolspecifiedforaSINGLEsessionisempty.
10Thenameoftheapplicationlistisnotfound.
NoAPPLISTcommandmatchesthenamespecifiedintheAPPLISTdataelement.
11Gatewaysetuperror.
Agatewayconfigurationcontainsinconsistentdefinitions.
Thisoccurs,forexample,iftheIMSASSIGNsessionserviceisselectedbuttheLTERMdataelementisnotdefinedaspartoftheconfiguration.
12Anunsupportedcommandorfunctionkeywasentered.
13TheprinterterminalidentifiedbythePRTNODEdataelementcouldnotbeacquired.
14Avirtualprinterterminalsessioncouldnotbeestablished.
15NoIMSoperatorsessionisactivewiththerequiredIMSCustomizingMessagesChapter5.
CL/SuperSessionCustomization55subsystem.
WheneithertheASSIGNortheDEQUEUEsessionserviceisselected,avirtualIMSmasterterminal(MTO)operatorsessionmustbeavailable.
16AnundefinedLTERMnamehasbeenspecified.
ThenameassociatedwiththeLTERMdataelementisnotdefinedintheIMS/DCgen.
17AnundefinedPTERMnamehasbeenspecified.
ThelogicalunitnameoftheVTAMterminalisnotdefinedintheIMS/DCgen.
Ifterminalpoolingisbeingused,thisnamewillbetheLUnameofthevirtualterminal.
18TherequestedLTERMisnotavailable.
TheLTERMisavalidLTERMname,buttheASSIGNcommandcouldnotassignthisLTERMtothesession.
19TheSTOPNODEcommandfailed.
ThiscommandisissuedbyavirtualMTOsession.
20TheDEQUEUENODEcommandfailed.
ThiscommandisissuedbyavirtualMTOsession.
21TheRESTARTNODEcommandfailed.
ThiscommandisissuedbyavirtualMTOsession.
22TheSTARTNODEcommandfailed.
ThiscommandisissuedbyavirtualMTOsession.
23TherequestedLTERMisinuse.
ThismessagecanoccurifthespecifiedLTERMisalreadyinanactivesession,andtheExtendedLTERMVerification(XLV)optionisrequested.
24Noauthorizedapplications.
25Resolutionlimitexceeded.
msg_identifierAcharacterstringbeginningwiththecharactersSMSGGWandcontainingnoimbeddedblanks.
ThemessageidentifierisdefinedinadialognamedKLSMSGGn(wherenisa1-digitnationallanguageidentifier).
msgtextAvalidstringexpressionupto255charactersinlength,tonotifytheuseroftheproblemorexception.
Bydefault,thetildecharacter(~)translatestoasinglequotemark(')whenamessageisdisplayed.
Ifyouwanttosendandreceivethetildecharacterinyourmessages,modifydialogsKLGMSG1EandKLGMSG2Pbyreplacingthetildewithacharacterthatyoudonotintendtouseinmessages.
Using&SYSPANELtoProcessGatewayErrorsYoucanspecifythe&SYSPANELfunctioninthemessagetextofanygatewaymessagenumber,toprovidethenameofapanelthatwillgointoeffectwhenevertheexceptionassociatedwiththemessageoccurs.
ForexampleMESSAGE1'&SYSPANEL(ERROR01)'The&SYSPANELmethodofprocessingconfigurationerrorscanbeextremelyvaluableinvconfigurationsthatdonotusethePANELdatasourceforacquiringvaluesfordataelementssuchasDESTCustomizingMessages56IBMCL/SuperSessionforz/OSCustomizationGuidevconfigurationswithdialogsthatdonotcontainabodysectionInsuchconfigurations,theVIGMSGsessionvariablecannotbeusedtodisplayconfigurationerrormessages,sincenoscreenimageisavailabletodisplaythemessage.
Thepanelnamedinthe&SYSPANELfunctioncanbeusedtodisplayerrormessagesandtopromptforadditionalinformation.
Theprologueandepiloguesectionsofthedialogcanperformadditionalprocessing,suchassettingvaluesforsessionvariablesorloggingoffthegateway.
DefiningApplicationsTheAPPLDEFcommanddefinestheapplicationsthatareaccessiblefromallgateways.
WhenyoudefineapplicationswithAPPLDEF,theyareallavailabletoallusers.
Ifyouareusinganapplicationselectionpanel,CL/SuperSessionpresentsallapplicationsonthatpanel.
Optionally,youcanassociateanauthorizedapplicationlist(APPLIST)withtheuserorgatewaytorestrictapplicationaccess.
ItisrecommendedthatyouincludeinaCLIST—forexample,&rhilev.
RLSCMDS(KLSCAPLS)—allAPPLDEFcommandsthatdefineproductionapplications.
However,youcanalsodefineapplicationsinprofiles.
SeetheBasicConfigurationGuideforinstructions.
ThesessionIDspecifiedintheAPPLDEFcommandcreatesauniqueapplicationdefinition.
Therefore,anyreferencetotheapplicationinothercommandsmustspecifythesessionID.
APPLDEFPurposeDefinesanapplicationthatisaccessiblethroughCL/SuperSession.
ContextCL/SuperSessionoperatorcommandFormatAPPLDEFsessidDEST=destid[ALTDEST=altdid][COMPRESS=YES|NO|IGNORE][DESC='string-exp'][GROUP=nnn|0][HELP=member][IMS=DEQUEUE|ASSIGN|'ASSIGN,DEQUEUE'|NO][INITDLG=dlgname][LOGON='string-exp'][MESSAGE='string-exp'][MULTSESS=YES|NO][NEWGROUP=nnn][NOLIST][ORDER=nnn|0][POOL=vsmpool|'*'][PRINTER=REQUIRED|OPTIONAL|NONE][PRTPOOL=vsmpool|'*']CustomizingMessagesChapter5.
CL/SuperSessionCustomization57[REMOVE][SIMLOGON=YES|NO|'data'][TERMDLG=dlgname][USERDATA='string-exp']ParameterssessidSpecifiesthenamethatdisplaysontheMainMenufortheapplicationidentifiedbytheDESTparameter.
ThesessionIDislimitedto8characters.
ThesessionIDcreatesauniqueapplicationdefinition.
Therefore,anyreferencetotheapplicationinothercommandsmustspecifythesessionID.
DESTIdentifiestheapplidservedbytheAPPLDEF.
Ifthatapplicationisnotavailable,thegatewayestablishesasessionwiththealternatedestinationdesignatedbyALTDEST.
TheDESTparameterisrequired.
WhenIMSsessionservicesarespecifiedbytheIMS=DEQUEUE/ASSIGNparameter,theDESTparameteridentifiesthenameofanIMSenvironmentdefinitionstatement.
ALTDESTIdentifiesthesecondaryalternatesessionIDservedbytheAPPLDEF.
IftheDESTapplicationisnotavailable,thegatewayestablishesasessionwiththeALTDESTapplication.
TheALTDESTapplicationtypicallyidentifiesanothercopyoftheapplicationrunningonabackupsystem.
TheALTDESTparameterisoptional.
COMPRESSDetermineswhethertousecompressionforthisapplication.
YESThesessioniseligibleforbothinboundandoutboundcompression,dependingontheuser,group,orglobalprofilesetting.
NOThesessionisnoteligibleforcompression.
Thisisthedefault.
IGNORELeavesineffectthedefaultyouestablishfortheuserbyexecutingtheadministratorfunctions.
COMPRESSisavalidparameteronlyifMULTSESS=YESisspecified.
DESCDescribestheapplicationorclarifiesitsusefordisplayontheMainMenu.
Themaximumlengthofthedescriptionis32characters.
GROUPIdentifiesarelatedgroupofapplications.
CL/SuperSessiondisplaysallapplicationswithanidenticalgroupnumbertogetherontheMainMenu.
Bydefault,eachapplicationgroupoccupiesadifferentmenupanel,andthegroupsaredisplayedindescendingorder.
Ifanapplicationbelongstogroup1,itdoesnotappearinitiallyontheMainMenu.
However,userscanstilladdtheapplicationtothesessionprofilelistoraccesstheapplicationwithaSTARTcommand.
(SeetheUser'sGuide.
)Therefore,specifyingGROUP=1doesnotservethesamepurposeascreatinganauthorizedapplicationlist.
IntheAPPLDEFcommandsprovidedinmembersKLGCAPLSandKLSCAPLSofDDNAMETLVCMDS,SINGLEAPPLDEF58IBMCL/SuperSessionforz/OSCustomizationGuideapplicationsuseGROUP=100;multisessionapplicationsuseGROUP=200;andCLSDSTPASSapplicationsdefaulttoGROUP=0.
HELPSpecifiesthehelppaneldisplayedwhentheuserselectstheapplicationwiththeHactioncode.
IMSThisparameterisusedwhenIMSsessionservicesarerequiredforaccesscontrolinIMS/DCapplicationsubsystems.
OmitthisparameterorspecifyIMS=NOifyouarenotusingIMSsessionservices.
ThedefaultisNO.
INITDLGSpecifiesavirtualsessioninitializationdialogforamultisessionenvironment.
Thisdialogreceivescontrolimmediatelyaftersessionestablishment.
TheINITDLGparameterperformsthesamefunctioninamultisessionenvironmentthattheLOGONparameterperformsforSINGLEsessions.
IfyouspecifyMULTSESS=NO,youmustuseLOGONinsteadofINITDLG.
IfyouusetheINITDLGparameter,youmustspecifyMULTSESS=YESfortheapplication.
Uponentrytodlgname,thevariable&sysparmwillcontainthesessionID.
LOGONDefinesaninitializationsequencetopasstothedestinationapplicationimmediatelyaftersessionestablishment.
Thesequenceprimestheapplicationbyenteringoneormoreinitialtransactions.
Forexample,theinitializationsequencecouldcompletealogon,whichLOGONwouldpassdirectlytotheapplication.
YoucanuseLOGONwithSINGLEsessionsonly.
Therefore,youmustalsospecifythePOOLparameter.
IfyouspecifyMULTSESS=YES,youmustuseINITDLGinsteadofLOGON.
Theinitializationsequencecanincludebothliteraldataandvariables.
Forexample,youcanimbedinitthevariablesthatcontainauserIDandpassword.
(SeetheDialogLanguageReferenceManual.
)Youcanalsoincludehexadecimaldata.
Useabackslash(\)toindicatethatthenexttwocharactersrepresentonebyteofhexadecimaldata.
Forexample,\C1representsthehexadecimalconstantC1.
Threekindsofhexadecimaldataareinterpretedas"waitformessage":\FFThegatewaytransmitsthedataprecedingthe\FF,thenwaitsfortheapplicationtogeneratearesponse.
Whenthegatewayreceivestheapplication'sresponse,itdiscardstheresponseandthentransmitsthenextstringofdatafromtheterminal,uptobutexcludingthenext\FF.
Whenitreachestheendoftheinitializationsequence,thegatewaydisplaystheresponsereturnedwiththelasttransaction.
Ifitencounters\FFwithoutanyprecedingdata,orifitencounterstwoadjacent\FFs,thegatewaystopstransmitting,andthevirtualsessionwaitsforanoutboundchainfromtheapplication.
The\FFissatisfiedbyanynon-nullRU.
\FDIfyouimbed\FDinthelogonsequence,thegatewaytransmitsthenextoutboundchainfromtheapplicationtotheterminal(ratherthandiscardingtheoutbounddata).
Thisallowstheusertoviewtheoutboundchainattheterminal.
APPLDEFChapter5.
CL/SuperSessionCustomization59\FEForreadpartitionqueryoperations,imbed\FEinthelogonsequence.
Thegatewaypassesthequerytotheterminalandwaitsforaresponse,whichitthenpassestotheapplication.
Logonstringprocessingissuspendeduntiltheterminalrespondstothemessagereceived.
MESSAGEContainsamessage(upto20characterslong)abouttheapplicationstatus.
Acustomizeddialogcanroutethemessageanddisplayitatusers'terminals.
However,themessageisnotstoredandisassociatedonlywiththesessiondefinedbytheAPPLDEFcommand.
Ingeneral,theIMBRCSTcommandisamoreefficientmethodtoinformusersofchangesinapplicationstatus.
SeetheOperator'sGuideformoreinformationontheIMBRCSTcommand.
MULTSESSTellsCL/SuperSessiontoestablishavirtualsessionwithamultisessionapplication.
IfMULTSESS=YES,thegatewayactivatesavirtualsession.
IfMULTSESS=NO,thegatewayestablishesaSINGLEsession.
WhilethisSINGLEsessionisactive,theusercannotuseanymultisessionproductfeatures.
IfyouspecifyMULTSESS=YES,youmustalsospecifythePOOLparameter.
ThedefaultisMULTSESS=YES.
NEWGROUPChangesthegroupassignmentforanexistingapplicationdefinition.
Thisdoesnotcreateanewapplicationdefinition;itsimplyassociatesanewgroupnumberwiththeexistingapplicationdefinition.
NOLISTAbbreviatesmessagesthatconfirmapplicationdefinitionsorupdates.
Ifyouomitthisparameter,thesystemdisplaysallAPPLDEFparametersforeachcommand.
NOLISTisparticularlyusefulinthestartupCLIST,becauseiteliminatesunnecessarymessagetrafficandlogentries.
ORDERDeterminesinitialplacementontheMainMenu.
Applicationsappearonthemenuinhigh-to-loworderwithineachgroup.
Bydefault,allapplicationsarearrangedbygroupnumber,byordernumber,andthenalphabeticallybysessionID.
Ifmorethanoneapplicationhasthesameordernumber,thesystemdisplaystheduplicateapplicationsalphabetically.
POOLSpecifiesthevirtualterminalpool.
vsmpoolSpecifiesthevirtualterminalpooldefinedbyaVSMcommand.
'*'DerivesthevirtualterminalpoolnamefromthePOOLdataelement.
IfPOOLisnotspecifiedorifPOOLisspecifiedwithout'*'or'&DEFPOOL',thegatewayignoresthePOOLdataelement.
IfthePOOLparameterisomitted,theapplicationbecomesCLSDSTPASS.
PRINTERSpecifieswhethertoestablishthesessioniftheprinterisnotavailable.
ThedefaultisNONE.
APPLDEF60IBMCL/SuperSessionforz/OSCustomizationGuideREQUIREDSpecifiesthattheprintnodemustberesolvedbeforeestablishingthesession.
OPTIONALEstablishesthesessionevenifanyoperationconcerningtheprinterfails(forexample,iftheprinterisbusy).
NONEBypassesallprinteroperations.
PRTPOOLSpecifiesthevirtualprinterterminalpoolthatestablishessessionsbetweentheuserandtheapplication.
vsmpoolIdentifiesthevirtualprinterpooldefinedbyaVSMcommand.
'*'DerivesthevirtualprinterpoolnamefromthePRTPOOLdataelementatthetimeofapplicationaccess.
IfPRTPOOLisnotspecifiedorifPRTPOOLisspecifiedwithout'*',thegatewayignoresthePRTPOOLdataelement.
(Requiredonlyforvirtualprintersessions.
)REMOVEDeletesapreviouslydefinedAPPLDEFapplicationdefinition.
IftheoriginalAPPLDEFstatementspecifiesaGROUPnumber,theAPPLDEFREMOVEstatementmustspecifythatsameGROUPnumber.
WhenyouspecifyREMOVEforanexistingAPPLDEF,andthesessionIDoccursinoneormoreauthorizedapplicationlists,theapplicationisremovedfromthoselists.
Tore-establishtheapplication,youmustreissueboththeAPPLDEFcommandandthecorrespondingAPPLISTcommand.
SIMLOGONQueuesaCLSDSTPASSsession(noPOOLparameter)tothegatewayafterterminationofthesession.
TheSIMLOGONparameterissuesaSIMLOGONOPTCD=Qonbehalfoftheuser'sterminallogicalunit.
Whentheuserlogsoffthesession,thesessionwiththegatewayisautomaticallyre-established.
IftheuserselectsaCLSDSTPASSapplication,thegatewaypassescontroltotherequestedapplication.
Whentheuserlogsofftheapplication,controlreturnstoVTAM.
Ifthegatewayisspecifiedasacontrollingapplication(VTAMLOGAPPL),oriftheuserselectsthegatewayfromVTAMUSS,theusermustrepeatthelogonsequence.
SIMLOGONautomaticallyre-establishesthesessionwiththegatewaywithoutimplementingaVTAMLOGAPPL.
Inaddition,ifthegatewayrequiresthattheuserre-enterauserIDandpassword,thisinformationcanbepassedtothegatewayasuserdatawhenthegatewaysessionisre-established.
Theuserseesonlyadirectreturntothegatewaywhentheapplicationterminates.
ToactivateSIMLOGON,specifyeitherYESor'data',where'data'isanyvalidstringorstringexpressiontobepassedtothecontrollinggatewayasuserdata.
Userdatamustbeenclosedinsinglequotes.
IfSIMLOGONistobeactivatedwithoutpassinganyuserdata,specifyYES(withoutsinglequotes).
ThedefaultisNO.
APPLDEFChapter5.
CL/SuperSessionCustomization61Important:YoucanuseeithertheFORWARDLOGAPPLortheAPPLDEFSIMLOGON,butdonotusebothforthesameapplication.
TERMDLGSpecifiesavirtualsessionterminationdialogformultisessionapplications/environmentsonly.
ThisdialogreceivescontrolupondetectionoftheVSSTERMdialogfunctionbeingissued.
ThespecifieddialogcannotcontainaVSSTERMfunction.
Itwillcausetheterminationdialogtoexecutetwice.
Uponentrytodlgname,thevariable&sysparmwillcontainthesessionID.
Note:Thisdialogdoesnotgetcontrolwhenauserperformsthenormallogoffsequenceforanapplication.
USERDATATransmitsauserdatasequencetothedestinationapplicationduringsessionestablishment.
Someapplications,includingTSOandTSO/E,inspectthecontentsofuserdataandusethedatatocompleteorsupplementthelogonprocess.
Theuserdatastringcanincludebothliteraldataandsessionvariables.
Forexample,youcanimbedintheinitializationsequencethevariablesthatcontainauserIDandpassword(&VIGUSERand&VIGPSWD).
Youcanalsoincludehexadecimaldata.
Useabackslash(\)toindicatethatthenexttwocharactersrepresentonebyteofhexadecimaldata.
Forexample,\C1representsthehexadecimalconstantC1.
TheUSERDATAparametertakeseffectbeforeLOGONorINITDLG.
SpecifyingMorethanOneAPPLDEFperApplicationInmostcases,thereisaone-to-onerelationshipbetweennetworkapplicationsandAPPLDEFapplicationdefinitions.
However,youmightwanttospecifyseveralAPPLDEFsforasingleapplication,toprovideuniquesessioncontrolsandservicesthrougheachaccesspath.
Forexample,youcoulddefineasingleIMS/DCapplicationregionwithtwoAPPLDEFs,thefirstforusersondedicatedlinesandthesecondfordial-inusers.
TheusersondedicatedlinescanbepasseddirectlytotheIMS/DCsubsystem.
Dial-inuserscanberoutedintoavirtualsessionusingavirtualterminalpool,allowingidlesessionstobedetectedandterminated,therebyincreasingresourceavailability.
YoucanalsouseseparateAPPLDEFcommandstodefinesubapplicationsgroupedbyfunctioninasinglesubsystem.
Forexample,payroll,accountsreceivable,accountspayable,andorderprocessingcanbedifferentapplicationsinthesameIMSorCICSsubsystem.
CL/SuperSessioncanlisteachoftheseapplicationsseparatelyonthemenu.
Astheuserselectstheapplication,CL/SuperSessioncanestablishthesessiondirectlywiththesubapplicationinIMSorCICS.
ThisfeaturerequiresSSPLprogrammingwithaninitialdialog.
ChangingApplicationDefinitionsDynamicallyYoucanissuetheAPPLDEFcommandfromeithertheCT/Engineoperatorfacilityorthez/OSconsole,tooverrideanyoftheapplicationparametersinthecurrentapplicationdefinition.
Forexample,tospecifyanewvirtualterminalpooldynamically,youcouldissuethefollowingcommand:APPLDEF62IBMCL/SuperSessionforz/OSCustomizationGuideAPPLDEFTSOPRODGROUP=100POOL=VIRTPOOLVIRTPOOLnowreplacestheexistingvirtualterminalpool.
Thischangebecomeseffectivefornewlogons,butdoesnotaffectusersalreadyinsessionwithTSO.
TodeleteaparameterfromanAPPLDEFcommand,specifytheparameterwithoutavalue.
Forexample,todeletethePOOLparameterfromtheAPPLDEFcommandshownabove,youwouldissuethiscommand:APPLDEFTSOPRODGROUP=100POOL=Note:IftheGROUPparameterisusedintheoriginalapplicationdefinition,youmustspecifytheGROUPparameterwhenyoureissuetheAPPLDEFcommand.
UsingApplicationDefinitionHelpTocreateasite-definedhelppop-upforasessionIDonthemainmenu,followthesesteps:1.
Createorreviseanapplicationdefinitiontoincludethisparameter:HELP=dialog1wheredialog1isanewmembernameandisusedinthenextstep.
Forinformationaboutcreatinganapplicationdefinition,seetheOperator'sGuide.
2.
Creatememberdialog1inthe&rhilev.
RLSPNLSdatasetbycopyingfromthismember:&thilev.
TLSPNLS(KLSH1HLP)3.
Modifythethirdlineinnewmemberdialog1.
whichreads:DIALOGKLSSHELPKLG010H&vsplangsothatitreads:DIALOGKLSSHELPdialog2wheredialog2isanothernewmembernameandisusedinthenextstep.
4.
Creatememberdialog2inthe&rhilev.
.
RLSPNLSdatasetbycopyingfromthismember:&thilev.
TLSPNLS(KLG010Hn)wherenisthenationallanguagedesignation(1=English).
Forinformationaboutlanguageselection,seetheUser'sGuide.
5.
Modifythetextinmemberdialog2tomeetyoursite'shelprequirements.
6.
Fromtheoperatorinterface,refreshdialog1anddialog2.
Forinformationaboutrefreshingdialogs,seetheOperator'sGuide.
7.
Fromtheoperatorinterface,activatetheAPPLDEFforwhichyoudefinedhelp.
Forinformationaboutactivatinganapplicationdefinition,seetheOperator'sGuide.
Result:Yourapplicationdefinitionisactivated.
Toselecthelp,entertheHactioncodenexttoasessionIDonthemainmenu.
ApplicationDefinitionExamplesThefollowingexamplesshowhowtousesomeoftheAPPLDEFparameters.
Example1APPLDEFTSODEST(TSO1)-USERDATA('LOGON&VIGUSERACCOUNT(&VIGACCT)')-SIMLOGON('&VIGUSER&VIGPSWD')ChangingApplicationDefinitionsDynamicallyChapter5.
CL/SuperSessionCustomization63Inthisexample,theTSOsessionIDrepresentsaTSOsubsystem.
WhentheuserselectsTSO,CL/SuperSessionusesthelogicalunitnamespecifiedintheDESTparametertoestablishasessionwithTSO.
SinceavirtualterminalpoolisnotspecifiedwiththePOOLparameter,thesysteminitiatesthesessionwithaCLSDSTPASS.
TheUSERDATAparameterdefinesacharacterstringtopasstotheapplicationwhenCL/SuperSessionestablishesthesession.
Toconstructtheuserdatastring,CL/SuperSessionsubstitutesvaluesforallvariablesinthestring.
Intheexample,theamp;VIGUSERvariablecontainstheuserID,and&VIGACCTcontainstheaccountnumber,soCL/SuperSessionreplacesthevariableswiththeproperuserIDandaccountnumber.
Whenthesystempassesthesession,TSOusestheuserdatastringtostartthelogonprocess.
TheSIMLOGONparameterdefinesacharacterstringtopassbacktothecontrollinggatewaywhenTSOterminates.
The&VIGUSERvariablecontainstheuserID,andamp;VIGPSWDcontainsthepassword.
WhentheTSOsessionends,theuserisautomaticallyloggedbackontothegateway.
IfthatgatewayresolvestheUSERIDdataelementbyUSERDATA(0)andthePASSWORDdataelementbyUSERDATA(1),theuserneednotre-enterauserIDandpassword.
Example2APPLDEFCICSDEST=CICSRGN1ALTDEST=CICSRGN2-DESC='HOTELRESERVATIONSYSTEM'-MESSAGE='AVAILABLETHISWEEKEND'Inthisexample,theCICSsessionIDcanrepresenteitheroftwoCICSapplicationregions:CICSRGN1andCICSRGN2.
WhentheuserselectsCICS,thegatewaytriestoestablishaCLSDSTPASSsessionwiththeprimarydestinationapplication(CICSRGN1)definedbytheDESTparameter.
Ifthatapplicationisnotavailable,thegatewaynexttriestostartaCLSDSTPASSsessionwiththealternativedestinationapplication(CICRGN2)definedbyALTDEST.
CICSRGN2providesabackupforCICSRGN1.
ACL/SuperSessionoperatorcanupdatethestatusmessagedynamicallybyreissuingtheAPPLDEFcommandwithanewMESSAGEparameter.
Thefollowingdialogexample,executedbyatrigger,allowsuserstoseethecurrentmessagetext(ortheendusercanissueanIactioncodeontheCLMainMenuforthedesiredmenuitem.
)optionpopuplevel(1))declareapplscope(local))prologueifnot&sysparmdosetappl(vssinfo('FOREGRID'))viggap(findappl'',&appl)endelseviggap(findappl'',&sysparm))attrs'*'type(output)color(yellow)display(high)''type(output)color(turquoise)display(high))bodytopinputMessagetextforsessionid&vigtokenApplicationDefinitionExamples64IBMCL/SuperSessionforz/OSCustomizationGuide>SESSIONIDMESSAGE'type(output)color(turquoise)display(high)'+'type(output)color(blue)display(normal)'='type(output)color(white)display(high)''type(input)color(green)display(normal)'"'type(skip)color(turquoise)display(normal)Figure18.
SampleMemberContainingCL/SuperSessionStandardAttributesSelecttriggerswitha/oranactioncode.
PhraseKeyDialogParameter\qENTERKLSQUIT\lENTERKLSLOCK\mENTERFigure19.
ExampleofaTableDisplayPhraseKeyDialogParameter)bodytableinput;s=&vsptdph&vsptdky&vsptddg&vsptdprFigure20.
CodefromDialogKLSTRG11,UsedtoDisplaytheTableChangingtheColorandOtherAttributesChapter8.
ProductDialogCustomization91showsthenewdisplayandFigure22thecodethatproducesit.
ModifyingPF12DependingonthenumberofPFkeysyouhaveonyourkeyboard,youmaywanttomodifythePF10keysoitfunctionsinthesamewayasthePF12key.
Todothis,enterthefollowinginthepanelyouwanttochange.
Thiswillnotchangethedisplay,butthePF10keywillactasthePF12key.
DisconnectingaLockedTerminalAspartofprofileadministration,theadministratorsetsatimeoutinterval.
Thisintervalistheamountoftimethataterminalcanbeidlebeforeitislocked.
Theterminalremainslockedandconnecteduntiltheuserentersapasswordtounlockit.
Youcansetasecondtimeoutintervalthatlogsoffthelockedterminaliftheusertakesnoactionafteradefinedperiodoftime.
(Thisdoesnotaffectuserswhoareallowedtopreserveactivesessionsuponexiting.
)Toimplementthesecondtimeoutinterval,modifydialogKLSUNLKPasfollows:1.
AfterthefollowingcodeinKLSUNLKP:)prologuesetunlock''setsyscsrunlockif(&systimeo)or(&vsptodlg)TIMEOUT(0)addthefollowingnewcodeforthesecondtimeoutinterval:/*Newcodetoaddsecondtimeoutinterval*/ifnot(&systimeo)/*Isthisanactualtimeout*/TIMEOUT(0)/*No*/Selectsessionswitha/oranactioncode.
PhraseDialogKeyParameter\qQUITENTER\lLOCKENTER\mENTERFigure21.
TableDisplayafterModificationPhraseDialogKeyParameter)bodytableinput;s=&vsptdph&vsptddg&vsptdky&vsptdprFigure22.
CodeModificationinDialogKLSTRG11)prologuesetmsgarea''setkeystr(fold'&syskey='F10'setsyskey'PF12'if&syskey='PF10'or&syskey='F10'setsyskey'PF12'/*abovelineinserted*/if((substr'&syskey',0,2)='PF')Figure23.
CodeModificationforPF12KeyChangingtheFormatofaTable92IBMCL/SuperSessionforz/OSCustomizationGuideelseTIMEOUT(&vsptoint:00)/*Yes*//*Endnewcode*/2.
Toactivatethischange,besuretorefreshdialogKLSUNLKnwherenisthelanguagedesignation(English=1).
AutomatingApplicationLogonSampledialogsareprovidedtohelpautomatethelogonprocedureforseveralapplicationsin&thilev.
TLSPNLS.
ApplicationDialogforAutomaticLogonTSOVMCT/Engineoperatorfacility(VTPOPER)CICSOMEGAMONforMVSKLSONTSOKLSONVMKLSONVTPKLSONCUAKLSONCICKLSONOMTouseoneofthesedialogs,specifyitastheinitialdialoginaprofile.
Alternatively,youcanspecifyINITDLG=dialognameintheAPPLDEFstatementthatdefinestheapplicationtoCL/SuperSessionwheredialognameisoneoftheautomaticlogondialogs.
FormoreinformationabouttheAPPLDEFcommand,seetheOperator'sGuide.
Whenauserselectstheapplication,theuserIDandpasswordenteredatlogonwillpasstotheapplicationwithoutbeingretyped.
ControlDialogThecontroldialogisidentifiedtoCL/SuperSessionbyVSSENTRY,andVIGENTRY.
Asthenameimplies,thecontroldialogcontrolsthesessionfortheuser.
Thecontroldialogisgivencontrolofthesessionwhenanyofthefollowingconditionsoccur.
vIfthehighest-levelpanelinadialogreturnstothedialogmanager,oriftheEXITstatementisissuedfromwithinanypanelinadialog,controlwillbegiventothecontroldialogifaCL/SuperSessionforegroundsessionisnotdefined.
IfaCL/SuperSessionforegroundsessionisdefined,thatsessionreceivescontrol.
vWhenaCL/SuperSessionforegroundsessionterminates,thecontroldialogcontrolsthesessionunlessaterminationdialoghasbeenspecifiedintheapplicationdefinitionorinthesessionprofile.
Ifaterminationdialoghasbeenspecified,thatdialogreceivescontrol.
vIfanyofthefollowingkeysequencesaredetected,thecontroldialogcontrolsthesession.
(multisessionapplicationsonly):–iftheAttnkeyispressed(SNAterminalsonly)–iftheSysreqkeyispressedtwiceinsuccession(SNAterminalsonly)–ifatriggerisentered,andthetriggerisdefinedtoCL/SuperSessionwitheitherablankoranulldialognameDisconnectingaLockedTerminalChapter8.
ProductDialogCustomization93ThecontroldialogcanexecuteanyCL/SuperSessionfunctionstatement.
However,inastandardenvironment,thecontroldialogusuallypresentstheuserwithalistofsessionsthatareavailablefortheirselection.
CustomizingVariables&rhilev.
RLSPNLS(KLSSDCL)declaresallCL/SuperSessionsessionvariables,andcommentsinthismemberexplainthevariables.
ImportantDonotmodifytheKLSSDCLdialog;useitforreferenceonly.
Productvariablemodificationmaycorruptthewayinwhichtheproductoperates,therebyproducingpossibleundesirableresults.
YoucanfindfurtherinformationaboutdialogvariablesintheDialogLanguageReferenceManual.
ImplementingaDialogIfyouhavemodifiedandsavedadialogin&rhilev.
RLSPNLS,usetheREFRESHcommandtocompileitandbringitintomemory.
EnterREFRESHfromtheCT/Engineoperatorconsoleorfromanz/OSconsole.
InthefollowingexampledialogDLOGXYisREFRESHed.
REFRESHPANELDLOGXYInthefollowingexample,theCT/EnginejobnameisKLV.
REFRESH,enteredatanz/OSterminal,refreshesdialogDLOGXY:FKLV,REFRESHPANELDLOGXYControlDialog94IBMCL/SuperSessionforz/OSCustomizationGuideChapter9.
CT/EngineCustomizationThischapterexplainsthefollowingcustomizationoptionsforCT/Engine.
vdefiningtheCT/EngineoperatorfacilityvCT/EngineoperatorfacilitysignonpanelvdefininganetworkentrypointwiththeDIALOGcommandvdialogmanageroptionsinKLVINDMvpresentationspacemanagerinitializationparametersinKLVINPSMvglobalsensetablesupportinKLVINSNSvdefiningthetabledatabaseinKLVINTBvVIEWLOGdatabaseallocationandinitializationparametersinKLVINVLGvVTAMprogramoperator(VPO)initializationparametersinKLVINVPOvvirtualsessionmanagerinitializationparametersinKLVINVSMvVTAMoptionsinitializationparametersinKLVINVTMDefiningtheCT/EngineOperatorFacilityTheCT/EngineoperatorAPPListheprimarylogicalunittowhichCT/Enginesystemoperatorsmustlogonorbeconnected,iftheyaretousetheCT/Engineoperatorfacility.
TheCT/Engineoperatorfacilityisafull-screenapplicationthatprovidesaninterfacetoissueCT/Engine,VTAM(bytheVPOcommand),z/OSJES(bythez/OScommand),andapplicationsubsystemcommands.
VTAMcommandsareacceptedonlywhentheCT/Engineprogramoperator(VPO)facilityisactive.
z/OScommandsareacceptedonlyiftheCL/SuperSessionjobstepisAPF-authorized.
NAMcanprovideaspecialauthorizationprocessforCT/Engineoperators,tolimitaccesstoauthorizedoperatorsonly,andtolimitissuanceofcertaincommandstosubsetsoftheauthorizedoperatorgroup.
FormoreinformationaboutNAM,seeChapter10,"NetworkAccessManager,"onpage105.
ToactivatetheCT/Engineoperatorfacility,issueaNODEcommandidentifyingtheACBnameoftheCT/EngineoperatorAPPL.
ItisrecommendedthatyouplacetheNODEcommandinaCLIST,tobeinvokedautomaticallyatstartup.
AsampleNODEcommandisprovidedin&rhilev.
RLSCMDS(KLSSTART).
Note:YoucandefinemorethanoneCT/Engineoperatorfacility,byfirstdefininganACBinSYS1.
VTAMLST(newname)andthenissuingaNODEcommandforeachoperatorfacility.
HereistheformatoftheNODEcommand:NODEacbname[TIMEOUT=hh:mm:ss|interval_in_seconds|0]abcnameSpecifiestheACBnameoftheCT/EngineoperatorAPPL,asdefinedinSYS1.
VTAMLST(newname).
TIMEOUTSpecifiesthelengthofidletimebeforeautomaticlogofffromtheCopyrightIBMCorp.
1997,201595CT/Engineoperatorfacility.
IfyouomitTIMEOUTorspecifyitaszero,notimeoutisenforced,andidleoperatorsessionsarenotterminated.
CT/EngineOperatorFacilitySignonPanelWhenanauthorizedCT/EngineoperatorlogsontotheCT/EngineoperatorAPPL,afull-screensignonpanelispresentedforuserIDandpasswordauthorization.
ThenameofthisspecialpanelisalwaysKLVENTRY,anditmustresidein&rhilev.
RLSPNLS.
AdefaultpaneldefinitionisdistributedwiththeCT/Engineproduct;however,youcancustomizethispanelbyusingtheSSPLlanguageasdefinedintheDialogLanguageReferenceManual.
DefiningaNetworkEntryPointwiththeDIALOGCommandTheDIALOGcommanddefinesanetworkentrypointforadialog-basedapplication.
Processinglogicandpresentationformatsareestablishedinpanellibraries.
MorethanoneDIALOGcommandcanbeissuedfromasingleCT/Engineenvironment.
EachDIALOGcommandmustrefertoauniqueACBname.
YoucanissueDIALOGcommandsatanytimefromtheCT/Engineoperatorfacility.
TostopaDIALOGprocess,issuetheCLOSEcommandfortheACBnameoftheDIALOGapplication.
Thisterminatesthephysicalandvirtualsessionsofalluserswhoareloggedontothatapplication.
Torestartthedialog,reissuetheDIALOGcommand.
Userswillhavetologonagain.
IfapanelreferencedbytheDIALOGcommandismodifiedduringCT/Engineexecution,youcanusetheREFRESHcommandtoupdatethedialog.
FordetailedinformationontheDIALOGcommand,seetheOperator'sGuide.
DialogManagerOptionsinKLVINDMDialogmanageroptionscanbecontrolledbyparametersin&rhilev.
RLSPARM(KLVINDM).
PRELOADPRELOADspecifiesdialogsthataretobecompiledatCT/Engineinitialization.
PRELOADdialog1dialog2.
.
.
dialogThenameofadialogtobecompiledinordertobeavailableafterCT/Engineinitializationwhenrequestedbyauser.
Anydialognotpreloadedwillbedynamicallyrefreshedthefirsttimeitisrequestedbyauser.
YoucancodemultiplePRELOADstatementsandmultipledialogsoneachPRELOADstatement.
CT/Engineinitializationwillbedelayedwhiletherequesteddialogsarecompiled.
Ifanyofthedialogscannotbecompiled,CT/Engineinitializationfails.
Thedefaultspecifiesthatnodialogsarepreloaded.
DefiningtheCT/EngineOperatorFacility96IBMCL/SuperSessionforz/OSCustomizationGuidePresentationSpaceManagerInitializationParametersinKLVINPSMTheERPTEXTparameterprovidesarecoveryfacilityforinvalidinputreceivedbythephysicalterminal.
Insteadofterminatingthesession,CT/EnginedisplaystheErrorRecoveryPop-up(ERP)onthescreen.
PressEntertoterminatethispop-upandallowCT/Enginetorecover.
ERPTEXT(inmemberKLVINPSM)definesthetextforthispop-up.
YoucancustomizethetextforlanguagesotherthanEnglishortoprovideasuitableerrorexplanationotherthanthedefault.
Thedefaultisshownbelow:TERMINALINPUTERROR.
PRESSENTERTORECOVER.
CT/Engineallowsupto24linesoftext.
Textoneachlinemustbeenclosedinquotesandmustnotexceed72characters.
Note:ERPTEXTmustberepeatedforeachline.
Forexample:ERPTEXT='ThisisasampleofERPTEXT.
'ERPTEXT='PressENTERtorecover.
'GlobalSenseTableSupportinKLVINSNSGlobalsensetablesupportprovidesanexternalmechanismfordefiningRPLsensecodeexceptionprocessingrules.
ThesensecoderulesdeterminehowCT/EngineprocessesVTAMRPLsenseinformationduringasession.
Thisfacilityallowsyoutomanagenonstandarddeviceandapplicationprocessingcharacteristics.
Sensecodesaredatareturnedbyasessionpartnerinresponsetoarequest.
Theyinformthesenderofunacceptablerequeststothereceiver.
CT/Engineusesastatictableofsensecodesandassociatedactions.
GlobalsensetablesupportallowsyoutomergeCT/Enginedistributionsenseruleswithcustomizedsenserulesforyoursite.
Thisfacilityisthesinglepointofcontrolforallsensecoderuledefinition.
CT/Engineglobalsensetablesupportprovides:voneinternaltablecontainingallsensecoderulesvdefinitionofsensecoderulestocontroltheexceptionprocessingofresourcesusingeitherexplicitorgenericnamesvloadingofsensecoderulesstoredinanexternalfilevabilitytodynamicallyrefreshtheglobalsensetableSenseRuleDefinitionStatementYoucaninputsite-specificsenserulesusingtheREFRESHoperatorcommandorthe&rhilev.
RLSPARMmemberKLVINSNS.
REFRESHCommandTorefreshthein-storageuserglobalsensetablelocatedin&rhilev.
SENSETBL(SNSIN)issuethefollowing:REFRESHSSNSIN&rhilev.
SENSETBLRefertotheOperator'sGuideformoreinformationontheREFRESHcommand.
PresentationSpaceManagerInitializationParametersinKLVINPSMChapter9.
CT/EngineCustomization97KLVINSNSMemberYoucancodethefollowingparametersin&rhilev.
RLSPARM(KLVINSNS)todefinesenserulestatements.
FormatLUSTAT|EXRESPSSENSE(xxxx)(USENSE(xxxx))FROMAPPL(name)|FROMLU(name)action1,action2.
.
.
,actionnParametersLUSTATIndicatesLUSTATprocessing.
LUSTATmaybeabbreviatedasL.
EXRESPIndicatesexceptionresponseprocessing.
EXRESPmaybeabbreviatedasE.
TheentrywillbeinvalidunlesseitherLUSTATorEXRESPappears.
SSENSEA4-digithexadecimalkeywordparameterthatdefinesthesystemsensecodevalue.
USENSEA4-digithexadecimalkeywordparameterthatdefinestheusersensecode.
USENSEdefaultstozeroswhennoparameterisused.
FROMAPPLA1-8characterkeywordparameterspecifyingtheapplicationLUthatthesenseblockentryisbuiltfor.
Thisparametermayincludewildcardcharacters.
Therearenodefaultsforthisparameter.
FROMAPPLdefinessenserulesforsensecodesreceivedbyavirtualterminalfromanapplication,suchasCICS.
FROMLUA1-8characterkeywordparameterspecifyingtheterminalLUthatthissenseblockentryisbeingbuiltfor.
Mayincludewildcardcharacters.
Nodefaults.
FROMLUisusedtodefinesenserulesforsensecodesthatCT/Enginereceivesfromaphysicalterminal.
ThenamespecifiedbytheFROMLUkeywordisthephysicalterminalname.
Note:TheFROMLUdispositionappliestoanyLUinsessionwithCT/EngineasanSLU.
ACTIONSThekeywordparametersthatdefineactionflagsettingsthatdescribetheexceptionhandlingprocessingforablockentry.
Thefollowingkeywordsareaccepted:CLEARClearsthesession.
CT/EngineissuestheSNACLEARcommandfollowedbySDTifaCLEARactionisspecified.
SeetheIBMmanualSNAReferenceSummaryfordetails.
DELAYCausesadelayedREADYTORECEIVEstatetobeset.
ValidwhenRESETisalsorequested.
SenseRuleDefinitionStatement98IBMCL/SuperSessionforz/OSCustomizationGuideDELAYandIMMEDIATEkeywordsaremutuallyexclusive.
Ifspecifiedtogether,theywillcauseasyntaxerror.
IMMEDIATECausesanimmediateREADYTORECEIVEstatetobeset.
ValidwhenRESETisalsorequested.
DELAYandIMMEDIATEkeywordsaremutuallyexclusive.
Ifspecifiedtogether,theywillcauseasyntaxerror.
LOGOFFCausesunconditionalterminationofthesession.
NODUMPRequeststhatanRPLdumpnotbetakenforthissensecode.
NODUMPdoesnotsuppresstheRPLdumpifKLSSYSINparameterDEBUG(Y)iscoded.
RESETCausestheretransmissionofthemessagesbeingrejected.
YoucanspecifyanIMMEDIATEretransmissionoraDELAYretransmissionof15seconds.
ExamplesThefollowingareseveralexamplesofsenserulestatements.
TodefineasenseruleforasensecodewherethesystemsenseisX'0821'andtheusersenseisX'0000',codethefollowing.
ThisruledefinesamaskforapplicationapplidswithCICSasthefirst4characters.
WhenanLUSTATwiththissensecodeisreceivedandtheACBnamematchesthemask,CT/Enginewillperformtherequestedaction.
LUSTAT,SSENSE(0821),FROMAPPL('CICS*'),CLEARTodefineasenseruleforasensecodewherethesystemsenseisX'0801'andtheusersenseifX'0000',codethefollowing.
Thisruleappliestoallphysicalterminalswithanycharacterasthefirstcharacter,followedby327andanycharacterstocompletethename.
WhenEXRESPisreceivedfromaterminalthatmatchesthismask,CT/Enginewillperformtherequestedactions.
EXRESP,SSENSE(0801),FROMLU('327*'),RESET,DELAYToprovideforphysicaldisconnectionofDIALUPterminalswhentheDIALUPlineisdisconnected,createamembercalledKLVINSNSin&rhilev.
RLSPARMandaddthefollowingstatements:LUSTAT,SSENSE(0802),FROMLU(TRM*),LOGOFFLUSTAT,SSENSE(082B),FROMLU(TRM*),LOGOFFLUSTAT,SSENSE(0813),FROMLU(TRM*),LOGOFFwhereTRM*uniquelyidentifiestheLUnamesofDIALUPterminals.
CreatethefollowingstatementsinmemberKLVINSNSof&rhilev.
RLSPARM:EXRESP,SSENSE(0813),FROMLU(TRA*),CLEAREXRESP,SSENSE(081B),FROMLU(TRA*),CLEARwhereTRA*uniquelyidentifiestheLUnamesofthesatelliteterminals.
SenseRuleDefinitionStatementChapter9.
CT/EngineCustomization99UsageNotes1.
Wildcardcharacters(*and)aresupported.
*Whenstandalone,causesamatchonanyAPPLorLUID.
Whenprecededbycharacters,matchesanydataforthelengthandportionofthestringnotexplicitlydefined.
Allcharactersfollowingthe*areignored.
Whenstandalone,matchesanyonecharactername.
Whenprecededorfollowedbycharacters,matchesanycharacterinthesamerelativepositionofthetargetstring.
2.
Whensyntaxerrorsareencounteredforsenserulesdefinedin&rhilev.
RLSPARM(KLVINSNS),CT/Engineinitializationcontinuesandtheinternaldefaulttableisloaded.
UsetheREFRESHcommandtocorrecttheerrors,andthenupdateKLVINSNS.
3.
TheVSSTRACEoperatorcommandshowsthemechanismtheLUsessionpartnerisusing(LUSTATorEXRESP)inordertorejectamessageortoreportstatuschangestotheotherhalfsession.
DefiningtheTableDatabaseinKLVINTBThetabledatabaseisaVSAMclusterusedtostoreandretrievepermanenttables.
Thesetablescontainprofileinformationsuchassessionandtriggers.
Accessiscontrolledby128-bytekeys.
MemberKLVINTBof&rhilev.
RLSPARMdefinesthetabledatabasetothesystem.
Itcontainsthefollowingparameters:dsname-disp[OLD|SHR]-primarysize[nnn]-secondarysize[nnn]-minimumtubpool[nnn]-maximumtubpool[nnn]Note:Ifyouspecifykeywordsfollowingdsnameusethecontinuationcharacter(-).
KLVINTBreadsonlythefirstlogicalcontrolstatement.
ImportantDonotmodifythefollowingparameters(withtheexceptionofdisp)exceptundertheguidanceofanIBMsupportrepresentative.
dsnameIdentifiestheVSAMclusternameofthetabledatabasedataset.
dispSpecifiesthedispositiontobeusedwhenallocatingthetabledatabase.
Note:SpecifyingSHRwillcauseVSAMclustercorruptioniftheclusterisopenedinwritemodeonmorethanoneCPU.
primarysizeInitialamountofstoragetobeallocatedwhenatableiscreated.
Defaultis2048.
Minimumis512.
Maximumis32767.
SenseRuleDefinitionStatement100IBMCL/SuperSessionforz/OSCustomizationGuidesecondarysizeAmountofstoragetobeacquiredwhenatablerequiresmorestoragethanisavailableinitspool.
Defaultis2048.
Minimumis512.
Maximumis32767.
minimumtubpoolMinimumnumberofinternalcontrolblockstobemaintainedinanavailablepool.
Defaultis20.
Minimumis12.
Maximumis248.
maximumtubpoolMaximumnumberofinternalcontrolblockstobemaintainedinanavailablepool.
Defaultis100.
Minimumis20.
Maximumis256.
Example-rvhilev-.
RLSTDBToimplementthetabledatabasefacility,performthefollowingsteps:1.
AllocatethetabledatabaseclusterduringCL/ENGINEinstallation.
2.
SpecifytabledatabaseinitializationparametersinmemberKLVINTBof&rhilev.
RLSPARM.
Formoreinformationonthetabledatabase,seetheDialogLanguageReferenceManual.
Note:ThetabledatabaseclusterandallotherCT/EngineVSAMfilesuselocalsharedresources(LSR).
VIEWLOGDatabaseAllocationandInitializationParametersinKLVINVLGTheCT/EngineVIEWLOGdatabasefacilityprovidesonlineaccesstoselectedcategoriesofCT/Engine-generatedmessages,bywayofanz/OSconsoleortheCT/Engineoperatorapplication.
SeetheMessagesManualformoreinformationonVIEWLOGconsolemessages.
ThelogismaintainedintheVSAMclusteryoudefine.
ToimplementtheVIEWLOGdatabasefacility,performthefollowingsteps:1.
AllocatetheVIEWLOGclusterduringCT/Engineinstallation.
2.
SpecifyVIEWLOGinitializationparametersin&rhilev.
RLSPARM(KLVINVLG).
MemberKLVINVLGof&rhilev.
RLSPARMdefinesVIEWLOGtothesystem.
Itcontainsthefollowingparameters:dsname[RESET]disp[OLD|SHR]ddname[DDN]dsnameIdentifiestheVSAMclusternameoftheVIEWLOGdataset.
RESETSpecifieswhethertheVSAMclusterisdefinedasreusable.
Thisparameterisoptional.
dispThedispositiontobeusedwhenallocatingtheviewlogfile.
Note:CodingSHRwillexposeyoutoVSAMclustercorruptioniftheclusterisopenedinwritemodeonmorethanoneCPU.
DefiningtheTableDatabaseinKLVINTBChapter9.
CT/EngineCustomization101ddnameControlshowthefilewillbeallocated.
IfRESETisspecified,theRBAissettozero(0)duringinitializationsothatthedataspacecanbereused.
VIEWLOGeventrecordingstopswhenanout-of-file-spaceconditionisencountered.
WhiletheCT/EngineSYSOUTlogdatasetcontinuestorecordallmessages,thelogisnotaccessiblethroughtheCT/Engineoperatorfacility.
Example-rvhilev-.
RLSVLOGRESETUsageNoteDSNAMEandDDNAMEcontrolVIEWLOGdatabaseallocation.
Table6.
VIEWLOGDatabaseAllocation.
Ifyouspecify.
.
.
Then.
.
.
DSNAMEonlyThedatabaseisdynamicallyallocated.
DDNAMEonlyTheclusterallocatedtothespecifiedDDNAMEisusedforthedatabase,butthereisnodynamicallocation.
DSNAMEandDDNAMEThedatabaseisdynamicallyallocatedusingthespecifiedDDNAME.
NeitherDSNAMEorDDNAMEVIEWLOGisdisabled.
VTAMProgramOperator(VPO)InitializationParametersinKLVINVPOIfVTAMcommandswillbeissuedthroughtheCT/Engineoperatorfacility,aVTAMprogramoperatorAPPLmustbedefinedinSYS1.
VTAMLST(newname).
VPOinitializationparametersmustbedefinedtoCT/EngineinmemberKLVINVPOoftheinitializationlibrary(&rhilev.
RLSPARM).
TheparametersforVPOinitializationarelistedanddiscussedbelow:acbnameBUFLN(bufln)SHARE(opr)[PASSWORD(pswd)]acbnameTheACBnameoftheVPOAPPLasdefinedinSYS1.
VTAMLST(newname).
BUFLNThebufferlengthusedbetweenCT/EngineandVTAM.
Therecommendedvalueis160.
SHAREThemaximumnumberofoutstandingVTAMoperatorcommands.
Therecommendedvalueis16.
PASSWORDAnoptionalACBpassword.
ThisparameterisrequiredonlyifanACBpasswordhasbeenspecifiedfortheVPOACBinSYS1.
VTAMLST(newname).
VIEWLOGDatabaseAllocationandInitializationParametersinKLVINVLG102IBMCL/SuperSessionforz/OSCustomizationGuideThisexampleusestherecommendedvaluesandcontinuationcharacter(-)toinitializeKLVLV002184n.
KLVLV002-BUFL(160)-SHARE(16)VirtualSessionManagerInitializationParametersinKLVINVSMTheKLVINVSMmemberallowscertainCT/Enginevirtualsessionmanager(VSM)optionstobespecified.
FormoreinformationonVSM,seetheDialogLanguageReferenceManual.
CLSDST-PASSEstablishmentTimeoutCT/EngineprovidesadefaultCLSDST-PASSvirtualsessionestablishmenttimeoutof60secondstopreventsessionhangswhenaCLSDST-PASSfailsforavirtualsession.
Tochangethedefault,enterthisstatementasthefirstlineoftheKLVINVSMmember:TIMEOUT=timeWheretimeiseitheranumericalvaluethatrepresentsthenumberofsecondsoratimevalueformathh:mm:sstowaitforthecompletionofaCLSDST-PASSoperation.
Note:VirtualsessionestablishmenttimeoutcanbedisabledbyspecifyingTIMEOUT=0.
Forexample,tosettheCLSDST-PASSvirtualsessionestablishmenttimeoutattwominutes,enterthisstatementasthefirstlineofKLVINVSM:TIMEOUT=120VTAMOptionsInitializationParametersinKLVINVTMTheKLVINVTMmemberallowscertainCT/EngineVTAMoptionstobespecifiedwiththefollowingparameters.
NOACQUIRESTEALINGIndicatesthatCT/EnginewillnotreleaseanLUtoaVTAMACQUIREcommand.
Whennotspecified,aVTAMacquirerequestwillimmediatelybehonored,andterminalswillbeunboundfromexistingsessionsandreleased.
ACB31BITIndicatesACBsarelocatedinextendedstorage.
YoumustberunningMVS/XAorMVS/ESA,andberunningMVS/DFP3.
2orgreatertospecifyACB31BIT.
ReviewIBMAPAROY13859.
ACB24BITIndicatesACBsarelocatedinprimarystorage.
Thisisthedefault.
RPL31BITIndicatesRPLsarelocatedinextendedstorage.
Thisisthedefault.
RPL24BITIndicatesRPLsarelocatedinprimarystorage.
VTAMProgramOperator(VPO)InitializationParametersinKLVINVPOChapter9.
CT/EngineCustomization103NIB31BITIndicatesNIBsarelocatedinextendedstorage.
Thisisthedefault.
NIB24BITIndicatesNIBsarelocatedinprimarystorage.
SPTIndicatessessionproceduretimeout.
CT/Engineprovidesadefaultsessionproceduretimeoutof60seconds,topreventphysicalterminalsfromhangingupwhilewaitingforsessionstostart.
Tochangethedefault,enterthefollowingasthefirststatementofmemberKLVINVTM:SPT=mm:ssThefollowingexamplesetsasessionproceduretimeoutoftwominutesandindicatesthatACBsarelocatedinextendedstorage.
SPT=2:00-ACB31BITVTAMOptionsInitializationParametersinKLVINVTM104IBMCL/SuperSessionforz/OSCustomizationGuideChapter10.
NetworkAccessManagerThischapterdescribesthefunctionsoftheNetworkAccessManager(NAM),andexplainshowtoconfigureNAMandmaintaintheNAMdatabase.
TheNetworkAccessManagerisoneofthefacilitiessuppliedwithCT/Engine.
NAMprovides:vsecuritysystemvinterfacetoanexternalsecurityproductvdatabasethatstoresuservariablesTheNAMrecordsstoredinakey-sequencedVSAMdatasetmakeuptheNAMdatabase.
WhenNAMisthechosensecuritysystem,theNAMdatabasealsoholdsencryptedsecurityinformation.
YoucandefineanumberofVSAMdatasetstocorrespondtodifferentNAMconfigurations,oryoucanuseonlyonedatasetforallconfigurations.
EvenifyouarenotusingtheNAMdatabaseasyoursecuritysystem,wedonotrecommenddeletingit.
OtherproductsmaystorevariablesintheNAMdatabase.
Thissectiondiscussesthefollowingtopics:-configuringtheNetworkAccessManager-maintainingtheNAMdatabase-printingtheNAMdatabase-userexitroutines-CA-ACF2considerationsConfiguringtheNetworkAccessManagerToconfigureNAM,youmust:vdefineaVSAMdatasetvspecifyasecuritysystemvdeclarevariablestotheVSAMdatasetMemberKLVINNAMofTLVPARMcontainsaninitialNAMconfiguration.
Thismemberdefinesacontrolpoint,thatis,asetofparametersthatdesignateaVSAMdatasetnameandasecuritysystemforaccessvalidation.
Youcandefinemorethanonecontrolpoint.
AllcontrolpointsmayusethesameVSAMdatasettostoresecurityandprofileinformation,oryoucandefineadifferentdatasetforeachcontrolpoint.
Ifyouhavenotalreadydoneso,examinethecontrolpointcurrentlydefinedinKLVINNAM,sothatyouknowwhatyourconfigurationlookslike.
CopyrightIBMCorp.
1997,2015105DefiningNAMControlPointsNAMcontrolpointsaredefinedduringCT/Enginestartup,bymemberKLVINNAMinTLVPARM.
Whenauserlogson,thecontrolpointspecifiedfortheACBtakeseffectandremainsineffectuntiloverriddenbyaCNTRLPTfunctioninadialog.
ForinformationontheCNTRLPTfunction,seetheDialogLanguageReferenceManual,LS53-3787.
Controlpointsspecifyasecuritysystem,aVSAMdataset,andcustomizedmessagesfortheNAMexceptionsthatoccurifyouusetheDBorRACFparameter.
ThemostcommonlyusedsecurityparametersanddatasetnameshouldbespecifiedforthefirstcontrolpointdefinitioninKLVINNAM,becausethisisthedefaultcontrolpoint.
Ifacontrolpointcannotbedetermined(thatis,ifnocontrolpointnamematchestheACBname),CT/Engineusesthedefaultcontrolpoint,whichisnamedDEFAULT.
Figure24showstheparametersthatdefineacontrolpointinmemberKLVINNAMofTLVPARM.
[control_point_name][DSNAME=dsname]-[DDNAME=ddname]-[DISP=OLD|SHR]-[EXIT=exit]-[SAF|NOSAF]-[RACF|NORACF]-[DB|NODB]-[CLASSES=classes]-[NAF|NONAF]-[NOTIFY|NONOTIFY]-[LOG|NOLOG]-[APPL=appl]-[REQSTOR=reqstor]-[STAT|NOSTAT]-[REUSEPW=8|reusepw]-[SUBSYS=subsys]-[MSG4='text']-[MSG8='text']-[MSG12='text']-[MSG16='text']-[MSG20='text']-[MSG24='text']-[MSG28='text']-[MSG32='text']-[MSG36='text']control_point_nameSpecifiesthecontrolpointname.
TodeterminesecurityforaparticularACB,usetheVTAMACBnamespecifiedintheHOSTGATE,NODE,orDIALOGcommand.
IfamatchingcontrolpointnameisnotfoundfortheACB,NAMusestheDEFAULTcontrolpoint(thatis,thefirstcontrolpointdefinedinKLVINNAM).
Ifyoudefinemorethanonecontrolpoint,youmustspecifythecontrolpointnameinallcontrolpointdefinitionsexceptthefirst.
IfthecontrolFigure24.
NAMControlPointParametersDefiningNAMControlPoints106IBMCL/SuperSessionforz/OSCustomizationGuidepointnameisomittedfromthefirstcontrolpointdefinitioninmemberKLVINNAMinTLVPARM,thenameDEFAULTisused.
DSNAMESpecifiestheNAMdatabaseassociatedwiththecontrolpoint.
IftheDBparameterisspecified,DSNAMEorDDNAMEmustalsobespecified.
DDNAMEWithDSNAME,controlshowthedatabasewillbeallocated:NoDSNAMEandnoDDNAME.
Nodatabasewillbeallocated.
DSNAMEandnoDDNAME.
Thedatabasewillbedynamicallyallocated.
DDNAMEandnoDSNAME.
TheclusterallocatedtothespecifiedDDnameisusedforthedatabase;thereisnodynamicallocation.
DSNAMEandDDNAME.
ThedatabaseisdynamicallyallocatedusingthespecifiedDDname.
DISPControlsthedatasetdispositionwhenthedatabaseisdynamicallyallocated:OLDThedatabaseisallocatedexclusively.
Nootherjobsmayallocatethedatabase.
IfanotherjobhasthedatabaseallocatedwhenCT/Enginestarts,NAMreportsthatitcannotallocatethedatabaseandCT/Engineinitializationterminates.
SHRThedatabaseisallocatedshared.
Otherjobsmayallocatethedatabase.
Note:CodingDISP=SHRwillcauseVSAMclustercorruptioniftheclusterisopenedinwritemodeonmorethanoneCPU.
IfDDNAMEisspecifiedwithnoDSNAME(inotherwords,nodynamicallocationistobeperformed),theJCLdatasetdispositionwilloverrideanyDISPvalue.
EXITSpecifiesanoptionalexitroutine.
EXIT=exitnameiscalledbeforeRACF,SAForDB,ifspecified.
ValidationmaycontinuewithothersecuritymethodsdependinguponthereturncodeinR15setbytheexit.
See"ControlPointUserExitRoutines"onpage117formoreinformation.
SAF|NOSAFSpecifiesthatthez/OSSystemAuthorizationFacility(SAF)resolvesNAMaccessandresourcevalidationrequests.
SAFoverridestheRACFandDBparameters.
ThedefaultisNOSAF.
NotethatwhenSAFisused,eightbytesofCommonSystemArea(CSA)storageisrequiredforeachactive,validateduser.
ThelocationofthisstorageisdependentontheNAMProcessingOptionDATA=.
ForadetaileddiscussionofSAF,refertoIBM'sOS/VS2SPLSupervisormanual.
RACF|NORACFSpecifieswhethertouseRACFtoresolveaccessrequests.
ThedefaultisRACFwhenRACFispresentinthesystem;otherwise,thedefaultisNORACF.
RACFoverridestheDBparameterandisoverriddenbytheSAFparameter.
IfSAFisspecified,NORACFisforced.
DefiningNAMControlPointsChapter10.
NetworkAccessManager107NotethatwhenRACFisused,eightbytesofCommonSystemArea(CSA)storageisrequiredforeachactive,validateduser.
ThelocationofthisstorageisdependentontheNAMProcessingOptionDATA=.
DB|NODBSpecifieswhethertheNAMdatabaseassociatedwiththecontrolpointwillbequeriedforaccessvalidation.
ThedefaultisDBiftheDSNAMEparameterisprovided,otherwisethedefaultisNODB.
ThisparameterisoverriddenbybothSAFandRACF.
IfDBisspecified,DSNAMEmustalsobespecified.
CLASSESSpecifiesanoptionalprotectedclasslist;thatis,amemberinTLVPARMthatcontainsinformationusedtoconstructthecorrectresourcevalidationrequestforthesecuritysystem.
TheNAMdatabase(DB)doesnotusethisfeature.
Referto"ProtectedClassLists"onpage154formoreinformation.
NAF|NONAFSpecifieswhethertologamessageintheNetworkAccessFacility(NAF)datasetifanyexceptionsresultfromNAMaccessvalidation.
ThedefaultisNAF.
NOTIFY|NONOTIFYSpecifieswhethertologamessageintheCT/EnginelogdatasetwhenanexceptionoccursduringNAMaccessvalidation.
ThedefaultisNOTIFY.
LOG|NOLOGSpecifieswhetherCA-TOPSECRETshouldorshouldnotloganunsuccessfulaccesstoaresource.
APPL(RACFandSAFOnly)OverridestheAPPLparameterusedontheRACINITorRACROUTEmacroinstruction.
Ifnotspecified,theAPPLparameterdefaultstotheACBNAMEofthecurrentCT/Engineapplication.
ThisparameterisignoredunlessRACForSAFisspecified.
REQSTOR(SAFOnly)FunctionsexactlyliketheREQUESTORparameteroftheRACROUTEmacroinstruction.
RefertoIBM'sRACROUTEMacroRereferencemanualformoreinformationabouttheRACROUTEmacro.
ThisparameterisignoredifNOSAFisspecifiedorimplied.
STAT|NOSTAT(SAFOnly)Controlswhetherthestatisticsintheuserprofileshouldbemaintainedornot.
STAT,thedefault,specifiesthatthestatisticsarecontrolledbythecurrentSETROPTSoptionsfortheinstallation.
IfNOSTATisspecified,thestatisticsarenotupdated.
Inaddition,nomessageisissuedbyRACFforasuccessfullogon.
Messagesarealwaysissuedforunsuccessfullogonattempts.
ThisoptioncanprovideimprovedlogonresponsetimesinaRACFenvironmentbyreducingIOtotheRACFdatabaseandeliminatingsystemenqueues.
ThisisparticularlybeneficialwithasharedRACFdatabase.
RefertoIBM'sRACFSecurityAdministratorsGuideformoreinformationaboutmaintaininglogonstatistics.
ThisparameterisignoredifNOSAFisspecifiedorimplied.
REUSEPW(DBonly)Specifieshowoftenausermayreuseapreviouspasswordasanewpassword.
Wheneverauserchangeshispassword,thisnumberofpriorpasswordsischecked.
IfthenewDefiningNAMControlPoints108IBMCL/SuperSessionforz/OSCustomizationGuidepasswordmatchesanyofthepreviousones,itisdisallowedandtheusermustchooseanothernewpassword.
Specifyavaluefrom0through8;8isthedefault.
0meansanexistingpasswordmaybeimmediatelyreusedasanewpassword.
SUBSYS(SAFOnly)FunctionsexactlyliketheSUBSYSparameterontheRACROUTEmacroinstruction.
RefertoIBM'sOS/VS2SPLSupervisormanualformoreinformationabouttheRACROUTEmacroinstruction.
ThisparameterisignoredifNOSAFisspecifiedorimplied.
MSG4OverridesthedefaultmessageKLVNA102USERNOTDEFINED.
MSG8OverridesthedefaultmessageKLVNA103PASSWORDNOTAUTHORIZED.
MSG12OverridesthedefaultmessageKLVNA104CURRENTPASSWORDEXPIRED.
MSG16OverridesthedefaultmessageKLVNA105NEWPASSWORDINVALID.
MSG20OverridesthedefaultmessageKLVNA106USERNOTDEFINEDTOGROUP.
MSG24OverridesthedefaultmessageKLVNA107USERACCESSREVOKED.
MSG28OverridesthedefaultmessageKLVNA108GROUPACCESSREVOKED.
MSG32OverridesthedefaultmessageKLVNA109TERMINALNOTAUTHORIZED.
MSG36OverridesthedefaultmessageKLVNA110APPLICATIONNOTAUTHORIZED.
TheEXIT,SAF,RACF,andDBcontrolpointparametersareresolvedinthefollowingorder:1.
EXIT=exit2.
SAF3.
RACF4.
DBIfyouusetheEXITparameter,thespecifiedexitroutineisinvoked.
Dependingonthereturncodepassedbytheexit,accessorresourcevalidationmaybecomplete,orcontrolmaybepassedtoSAF,RACF,orDBforfurthervalidation.
IfyoudonotusetheEXITparameter,theresolutionorderisasfollows:1.
IfSAFisspecifiedwithRACF,DB,orboth,SAFcontrolsaccessandresourcevalidationforthecontrolpoint.
2.
IfRACFisspecifiedwithDB,RACFcontrolsaccessandresourcevalidationforthecontrolpoint.
DefiningNAMProcessingOptionsFigure25showsthestatementsthatmaybeusedtodefineNAMprocessingoptions.
[DATA=BELOW|ABOVE][FIELDEXIT=fieldexit]Figure25.
NAMProcessingOptionsStatementsDefiningNAMControlPointsChapter10.
NetworkAccessManager109DATAControlswherethesecuritycontrolblocksareallocatedbytheCT/EngineNAMroutines:BELOWControlblocksareallocatedin24-bitstorage(RMODE24).
ABOVEControlblocksareallocatedin31-bitstorage(RMODE31).
Whenacontrolpointexitroutineisbeingused,bit#EPF1D31inthe#EPFLG1flagbyteofthe$NAMUEPLparameterlistmaybeexaminedtodeterminewheresecurityblocksshouldbeallocated.
FIELDEXITSpecifiesafield-validationexitroutine.
CL/SuperSessionnormallyrequiresthatthedatacontainonlyprintablecharacters.
Auserexitmaybegivencontroltovalidateeachfieldusingdifferentrequirements.
See"FieldValidationUserExitRoutines"onpage121formoreinformation.
KLVINNAMExamplesExample1:UsingKLVINNAMtoSpecifyMorethanOneControlPointInthisexample,theCT/EngineoperatorfacilityandGATEWAY1areunderthecontrolofNAM;allothergatewaysareunderthecontrolofRACF.
Youmightwanttousethiskindofsetuptocreatetwolevelsofsecurity:onefordatacenterpersonnel(underNAM),andoneforallotherusers(underRACF,withdynamicapplicationlists).
Inaddition,afieldvalidationexitroutinehasbeenspecified.
Thisroutinewillgetcontroltovalidatealldatafieldsbeforetheyarepassedtothecontrolpointexitand/orthez/OSsecuritysystem.
DefinethreecontrolpointsinTLVPARM(KLVINNAM):FIELDEXIT=KLVNAMPXDEFAULTRACFCLASSES=externalKLVLV000NORACFDBDSNAME=prefix.
KLV.
NAMKLSGW001NORACFDBDSNAME=prefix.
KLV.
NAMExample2:UsingaDialogtoSpecifyMorethanOneControlPointInTLVPNENU,createadialogcontainingthisprologue:)prologueCNTRLPT(cntrlptname)SETmajorkey(VGET('&VSSUSER'var))VPUT('&VSSUSER'var'str')CNTRLPT(DEFAULT)wherecntrlptnameisthenameofacontrolpointdefinedinTLVPARM(KLVINNAM).
Inthisexample,thefirstVGETandVPUTusecntrlptname,andsubsequentVGETsandVPUTsusetheDEFAULTcontrolpoint.
FormoreinformationonCNTRLPT,VGET,andVPUT,seetheDialogLanguageReferenceManual.
Example3:SpecifyingMoreThanOneNAMDatabaseYoucansetupmorethanoneNAMdatabasebyspecifyingadifferentdatasetnameineachcontrolpointdefinition.
DefiningNAMProcessingOptions110IBMCL/SuperSessionforz/OSCustomizationGuideDefinetwocontrolpointsinTLVPARM(KLVINNAM):DEFAULTDSNAME(dsname1)KLSGW002DSNAME(dsname2)wheredsname1anddsname2arethenamesoftwoVSAMdatasetstobeusedfortwoNAMdatabases.
IfauserlogsontoGATEWAY1,thegatewaywillusedsname1astheNAMdatabase.
IfauserlogsontoGATEWAY2(ACBnameKLSGW002),thegatewaywillusedsname2astheNAMdatabase.
ProtectedClassListsYoumustdefineprotectedclasslistsifyouintendtouseeitherdynamicapplicationlistsortheRESOURCEdialogfunction.
AprotectedclasslistisamemberinTLVPARMthatcontainsinformationusedtoconstructthecorrectaccessrequestforthesecuritysystem.
ThismemberisthenspecifiedontheCLASSES=keywordonacontrolpointdefinitioninmemberKLVINNAM.
Adynamicapplicationlistusesthesecuritysystemtoretrieveandbuildalistofauthorizedapplications.
TheBasicConfigurationGuide,LS55-3785,explainshowtosetupdynamicapplicationliststhroughRACF,CA-ACF2,andCA-TOPSECRET.
ForinformationontheRESOURCEdialogfunction,seetheDialogLanguageReferenceManual.
Theresourceclassnamesdefinedtothesecuritysystemcontrolaccesstospecificresources(forexample,physicalterminalIDs).
ProtectedclasslistsprovideaconnectionbetweentheresourceclassesdefinedtoyoursecuritysystemandtheresourceclassesdefinedtoNAM.
Figure26showstheparametersofaprotectedclasslist.
classSpecifiesa1-to8-characterinternalresourceclassname.
ThisistheresourceclassnamedefinedtoNAM.
TheinternalresourceclassnameassociatedwithdynamicapplicationlistsisVGWAPLST.
YoucandefineotherinternalresourcenamesandinvokethemwiththeRESOURCEdialogfunction.
EXTERNALSpecifiesa1-to8-characterexternalresourceclassname.
Theexternalresourceclassnamemustmatchtheresourceclassnamedefinedtoyourexternalsecuritysystem.
(ACF2only)ACF2limitsresourceclassnamestofourcharacters.
TheprovidedACF2exit(memberKLVA2NEVofAKLVSAMP)prefixesthisnamewiththeresourcestorageclasscharacterR.
Therefore,yourexternalresourceclassnameforACF2canbeonlythreecharacterslong.
(RACFonly)TheexternalresourceclassnamemustcorrespondtotheCLASSparameterontheRACHECK(FRACHECK)macro.
class[EXTERNAL=external]-[APPL=appl]-[READAUTH=00|readauth]-[REQSTOR=reqstor]-[SUBSYS=subsys]Figure26.
ProtectedClassListParametersKLVINNAMExamplesChapter10.
NetworkAccessManager111APPL(RACF/SAFonly)CorrespondstotheAPPLparameteroftheRACINITmacro.
READAUTH(TOPSECRETonly)Specifiesthebit(s)intheTOPSECRETINAACCfieldthatindicatereadaccess.
Allbitsmustbeontoindicatereadaccess.
Ifomittedorzeros,theINAACCfieldisignoredandtheTOPSECRETreturncodeisusedtoindicatereadaccess.
Mustbetwohexadecimaldigits.
REQSTOR(SAFonly)CorrespondstotheREQSTORparameteroftheRACROUTEmacro.
SUBSYS(SAFonly)CorrespondstotheSUBSYSparameteroftheRACROUTEmacro.
MaintainingtheNAMDatabaseTheNAMdatabasecanbemaintainedbyeitheroftwofacilities:vNAMcommandoftheCT/EngineoperatorfacilityvTLVPNENUdialogsThefourrecordtypesstoredintheNAMdatabasearedescribedbelow.
Tomaptheserecords,usethe$NAMRmacrosuppliedinTLVMACmemberKLV$$MAC.
TypeofRecordandDescriptiondatabasecontrolThisrecordcontainsinformationaboutthedatabase,suchasthedateandtimeitwasdefined,andthedateandtimeitwaslastaccessed.
Eachdatabasehasonecontrolrecord.
Themajorkeyis0,andtheminorkeyis0.
usercontrolTheserecordsarepresentonlyiftheNAMdatabasevalidatessecurityforacontrolpoint(thatis,iftheDBparameterisspecifiedintheNAMcontrolpointdefinition).
Usercontrolrecordscontainthepasswordandexpirationparameters.
TheserecordsarecreatediftheNAMSETcommandincludesapassword.
Theminorkeyis0.
variablecontrolTheserecordscontainthevariablenamesassociatedwithaNAMdatabase.
VariablecontrolrecordsaredefinedbytheNAMDECLAREcommand.
YoumustDECLAREeachvariablebeforeyoucanrefertoitinaNAMSETcommand.
Themajorkeyis0.
Theminorkeyisthevariablename.
uservariableTheserecordscontainthevariablenamesandtextassociatedwiththemajorkey.
ThemajorkeyisdefinedbytheNAMSETcommand,andisusuallyauserIDoraterminalID.
ForcompleteinformationontheNAMcommand,seetheOperator'sGuide.
ProtectedClassLists112IBMCL/SuperSessionforz/OSCustomizationGuidePrintingtheNAMDatabaseYoucanprinttheNAMdatabaseatanytime,evenwhileCT/Engineisrunning.
UsemembersKLVASM,KLVNAMPT,andKLV@NAMofTLVSPENU.
1.
IfyouwanttoprintthedatabasewhileCT/Engineisrunning,specifyDISP=SHRonthecontrolpointspecificationinKLVINNAM.
2.
ToassembletheprintprograminmemberKLVNAMPTandlinkittoTLVLOAD,usethesourcecodeinmemberKLVASM.
3.
ToprinttheNAMdatabase,runthejobinmemberKLV@NAMinTLVSPENU.
HereisanexampleofoutputfromtheNAMdatabaseprintjob.
DATABASECONTROLRECORDDATABASEDEFINEDON10/10/88at17:51:23BYJOBNAMEONSYSTEMSYSALASTACCESSEDON11/12/88at14:12:26BYJOBNAMEONSYSTEMSYSANAMDATABASERECORDSFORAPAR01VSPSD00:TSOBVSPSD01:MSAVSPSD40:DVSPSD41:DRACFandSAFConsiderationsThissectioncoverssomeoftheoptionsthatareavailablewhenyouuseRACForSAF.
TheSystemAuthorizationFacility(SAF)providesaninstallationwithcentralizedcontroloversystemsecurityprocessingthroughasystemservicecalledthez/OSrouter.
Thez/OSrouterprovidesafocalpointforallproductsthatprovideresourcemanagement.
Theresourcemanagementcomponentsandsubsystemscallthez/OSrouteraspartofsecuritydecision-makingfunctionsintheirprocessing,suchasaccesscontrolcheckingandauthorization-relatedchecking.
Thesefunctionsarecalled"controlpoints.
"SAFsupportstheuseofcommoncontrolpointsacrossproductsandacrosssystems.
SAFisthepreferredsecurityinterfaceforCT/EngineandcanbeusedbyinstallationsthathaveCA-ACF2orCA-TOPSECRETaswellaswithRACF,withouttheneedtohaveanyNAMexitsinstalled.
RefertoyoursecurityproductdocumentationforinformationregardingtheuseofSAF.
SecuringCT/EngineApplicationswithRACFWhentheVALIDATEdialogfunctionisissuedtovalidateauser'ssecuritycredentials,CT/EnginesetsthecurrentACBnameastheAPPLparamterofaRACINITorRACROUTEREQUEST=VERIFYmacro.
BycreatingresourcesintheIBM-suppliedAPPLclassyoucancontrolwhichuserscanusetheapplicationastheyenterthesystem.
UsetheUACCoperandofanRDEFINEcommandtodefinethedefaultuniversalaccesstoaparticularapplication,andissuePErmitcommandstopermitaccesstoindividualusersorRACFconnectgroups.
SpecifyingAPPL=foracontrolpointdefinitioninKLVINNAMcanbeusedtoreducethetotalnumberofprofilesthatneedtobedefined.
PrintingtheNAMDatabaseChapter10.
NetworkAccessManager113Note:CT/EnginedoesnotRACLISTAPPLclassprofiles.
Forperformancereasons,andtoallowapplicationresourceprofilechangestobeimmediatelyavailable,considerusingSETROPTSGENLISTorRACLISTprocessingfortheAPPLclass.
Forfurtherinformation,seeIBMRACF:SecurityAdministratorsGUIDE.
RACFSecuredSignonSupportYoucanusetheSecuredSignonfeatureofRACFwhichallowsaccessvalidationtobeperformedusingasingle-usepasswordsubstitutecalledaPassTicket.
ACT/EngineapplicationcanacceptaRACFPassTicketcreatedbyaremoteauthenticationserviceonbehalfofauserwithoutanychangestotheCT/Engineapplication.
RACFusesthevaluepassedontheAPPLparameterofaRACINITorRACROUTEREQUEST=VERIFYtoretrieveaprofiledefinedtothePTKTDATAresourceclass.
ThisprofilecontainsasecretsecuredsignonkeythatisusedtoderivethePassTicket.
NotethatthedefaultAPPLparameteristheACBNAMEofthecurrentapplication,althoughthiscanbeoverriddenbyspecifyinganAPPLparameterfortheNAMcontrolpointdefinitioninKLVINNAM.
GeneratingaPassTicketWhenCT/Engineisusedtologontoapplicationsviaavirtualterminal,alogondialogcanbeusedtoautomatethelogonprocess.
TheuseridandpasswordusedtoaccesstheCT/EnginedialogapplicationcanbereplayedtothevirtualsessiontoachieveSingleSignon.
Theuseridandpasswordmustbekeptinstoragetoaccomplishthis,althoughthepasswordisusuallymaskedwithaproprietaryalgorithm.
WhenaccesstotheCT/EnginedialogapplicationismadewithaPassTicket,orforsitesrequiringahigherdegreeofsecuritythanisofferedbytheproprietarymaskingalgorithm,CT/EnginecangenerateaRACFPassTicketforuseinavirtualsessionlogondialogusingthePASSTICKETdialogfunction.
AsuccessfulVALIDATEfunctionmustbeperformedbeforethePASSTICKETdialogfunctioncanbeused.
ThisisnormallydoneatlogontotheCT/Engineapplication.
IfRACFPassTicketsaretobeusedforvirtualsessionlogons,andaregularpasswordisusedatinitiallogon,thenthepasswordshouldbeobliteredfrommemoryassoonaspossible.
TodeterminewhetherPassTicketsupportisenabledfortheCT/EngineapplicationaPASSTICKETdialogfunctionshouldbeperformedafterinitiallogon.
Anegativereturncodeindicatesthatthesupportisnotenabled,otherwisethepasswordvariablemaybedeletedandthestoragethatitoccupiederadicated.
IfyouwishtousePassTicketsforvirtualsessionlogons,andeliminatethein-storagecopyofpasswords,thefollowingexampleSSPLdetermineswhetherPassTicketsupportisenabledforthecurrentcontrolpoint,eradicatesthepasswordvariablecontentsanddeletesthevariable.
Notethatinordertoentirelyeraseavariable'scontents,itmustbereplacedwithdatathatisthesamelengthasit'soriginalcontents.
if(PASSTICKET('&userid''&sysappl''&systerm''PassTkt'))LT0doset'pswd'(REPEAT('',(LENGTH('&pswd'))))set'pswd'''SecuringCT/EngineApplicationswithRACF114IBMCL/SuperSessionforz/OSCustomizationGuideOncethepasswordiseradicated,singlesignoncanonlybeaccomplishedusingaPassTicket.
AlllogondialogsmustissuethePASSTICKETdialogfunctiontoreturnaPassTicketwhichcanbeenteredintoavirtualsessionapplicationlogonscreeninplaceofthepassword.
Forexample:setrc(PASSTICKET('&userid''&sysparm''&systerm''PassTkt''PTMsg'))ifrc=0vsstype('&sysparm''&PassTkt')elsedodialogerrmsg'&PTMsg'returnendAPassTickethasonlyashortusefullife,andmayonlybeusedonce,andonlyforthedestinationapplicationanduseridforwhichitwasgenerated.
PassTicketNAMExitThePASSTICKETdialogfunctioninvokesaNAMexitwithafunctioncodeof36.
Asampleexit,KLVRFPTX,isprovidedthatvalidatestherequestinguser,andcallstheRACFservicetogenerateaPassTicket.
TheexitshouldbeassembledandlinkedwiththeJCLprovidedinmemberKLV@ASMof&thilev.
TLVSPENU,specifyingaloadlibrarythatisdefinedtotheCT/EngineJCLprocedureconcatenationofDDNAMETLVLOAD.
ThefollowingNAMuserexitparametersarepassedforaPASSTICKETrequest:Table7.
NAMUserExitParameterListforPASSTICKETcall.
.
FieldDescription#EPFC36(#EPFCPTK),indicatingPASSTICKETgenerationrequest.
#EPTERMAddressofsourceterminalidvector.
#EPAPPLAddressofeightbytesourceapplid.
#EPDUIDAddressofdestinationuseridvector.
#EPDESTAddressofdestinationapplidvector.
#EPAUBAddressof$NAMAUB#EPPTKTAddressofreturnedPassTicketvector.
#EPMSGAddressofareturnedmessagevectoror0.
#EPAUBAddressofActiveUserBlock($NAMAUB).
$AUACEEAddressofRACFACEEcreatedbylogon,ifinuse.
$AUUSERUserIDofrequestinguser.
ToensurethatonlythoseusersauthorizedtogenerateaPassTicketforaparticularuseridanddestinationapplicationareallowedtodoso,thesampleexitprovidesamethodofvalidatingaPASSTICKETrequest.
ThemethodassumesthataRACFgeneralresourceclasscalledPTKTVALisdefinedtotheRACFClassDescriptorTable(CDT)withthefollowingattributes:PTKTVALICHERCDECLASS=PTKTVAL,ID=NNN,MAXLNTH=39,RACFSecuredSignonSupportChapter10.
NetworkAccessManager115FIRST=ANY,OTHER=ANY,POSIT=76,RACLIST=ALLOWED,OPER=NOAnIDvaluemustbechosenthatdoesnotconflictwithanyexistingclass.
Acompletioncode4willresultfromtheassemblyoftheCDTbecauseofthenon-standardCLASSandPOSITvalues.
APOSITvalueof76ischosentoassociatethisclasswiththeIBM-suppliedclassPTKTDATAwhichisusedtocarrysecuredsignonapplicationinformation.
TheRACFroutertablemustbeupdatedtoincludethePTKTVALresourceclasswiththefollowingentry:PTKTVALICHRFRTBCLASS=PTKTVAL,ACTION=RACFForthesechangestotakeeffectyoumustIPLthesystemspecifyingCLPAtorebuildthePLPA.
ToenableRACFsecuredsignonandCT/EnginePassTicketvalidationyoumustlogontoTSOwithaRACFsystemspecialattributeuseridandissuethefollowingcommands:1.
ActivatetheIBM-suppliedPassTicketresourceclassPTKTDATAandtheCT/EnginePassTicketvalidationresourceclassPTKTVAL.
SETROPTSCLASSACT(PTKTDATA,PTKTVAL)2.
ThePTKTVALclassshouldbedefinedtosupportgenericprofiles:SETROPTSGENERIC(PTKTVAL)3.
ThePTKTDATAandPTKTVALresourceclassesshouldbeRACLISTedinglobalstorage(adataspace):SETROPTSRACLIST(PTKTDATA,PTKTVAL)NowyoucandefineprofilestothePTKTDATAclasstoidentifyeachapplicationthatmayacceptaPassTicket.
Thepurposeoftheprofileistoassociateasecretkeywithaparticularapplicationrunningonaparticularsystem.
ProfilesaredefinedwiththeRDEFINERACFcommand:RDEFPTKTDATAapplid0Theexithasrejectedtheparameter.
TheNAMfunctionwillbeterminated.
0)DOVSSTERM(&VSPID1)RETURN&RCENDSETRSRCNM'&VSSAPPL'TheLINKstatementwouldnowlooklikethis:SETRC(LINK(KLVA2INH'&VSSUSER'&SRCNM&RSRCNM))RuleListInterpretSupportBeforeRLI,aseparateACF2generalizedresourcerulecall(whichgeneratedanSVC)wasrequiredtovalidateaccesstoeachresource.
Numerouscallswerenecessarytovalidateandconstructadynamicapplicationlist.
RLIrequiresonlyonecalltovalidatetheentirelist.
InstallationRLIisautomaticallyassembledintomemberKLVA2NEVofTLVSPENU.
Globalcharactersymbolssetbytheinvocationofmacro@ID(inSYS1.
ACFMAC)determinethereleasenumberofACF2.
Duringassembly,thisinformationgeneratesthecorrectobjectcodeinKLVA2NEV.
ImplementingGroupProfileswithACF2Note:ThissectionappliesonlytoCL/SuperSession.
IfACF2isperformingyourentryvalidationandyouwanttoimplementgroupprofiles,youwillneedcodeadefaultgroupandassignittousers.
1.
Haveyoursecurityadministratordefinean8-bytegroupfieldintheACF2LogonID(LID)record.
Forexample,thefollowingstatementdefinesthefieldGWGROUPintheuserportionoftheLIDrecord.
@CFDEGWGROUP,LIDGWGRP,CHAR,ALTER=SECURITY+LEADER,GROUP=10,LIST=ALL,ZERO=YES,FLAGS=NULL2.
AddthefollowingcodetoTLVSPENU(KLVA2NEV),theACF2userexit.
DuringlogonthiscodequeriesthevalueofthegroupfieldandsetsthesessionvariableMPCDFLT.
CLILIDGWGRP,C''BENOGRP$USREXITPUTVAR,NAME='MPCDFLT',AREA=LIDGWGRP,LENGTH=L'LIDGWGRPNOGRP$3.
InsertthefollowingcodeintotheprologueofAKLSPNLS(KLSUDEF),atthepointwherethegroupprofileisresolved.
DuringlogonKLSUDEFsetsuptheuser'sprofilevariables.
/*Opengroupprofile.
Ifitdoesn'texist,createonefromNAM.
*/setvspdflt&vupdflt/*Foldtouppercase.
*/ifnot&vspdflt/*Gotavaluefromuserprofile.
*/doifnot&mpcdflt/*Ifthereisnovalue*/setmpcdflt'SSUSER'/*settoSSUSER.
*/setmpcblank'&index('&mpcdflt'Striptrailingblanks.
*/LogonInheritanceSupport126IBMCL/SuperSessionforz/OSCustomizationGuideif&mpcblanklt0setmpcblank8setvspdflt'&substr('&mpcdflt',0,&mpcblank)'/*Setupvspdflt.
*/endIfyouwanttheGLOBALprofiletobeusedasthedefaultgroupprofile,eliminatetheassignmentofSSUSERto&MPCDFLT.
IfyouareusinganexternalsecuritysystemotherthanACF2,youcanadaptthisgeneralproceduretofityoursecuritysystem.
Formoreinformationongroupprofiles,seetheBasicConfigurationGuide.
ValidatingOnlytheACF2UserIDYoucancustomizetheKLSA2NEVexittointerrogatewhetheranACF2userIDisvalidwithoutcheckingtheuser'spassword.
YoucanusethismethodtocleanupunuseduserprofilesintheTDB.
ToimplementvalidatingonlytheuserID,dothefollowing:1.
ModifytheKLVINNAMmemberoftheinitializationparameterlibrary&rhilev.
RLSPARMtoincludeanadditionalACF2controlpoint.
2.
CreateanewuserexitbycopyingandmodifyingKLSA2NEV.
YoucanrefertothesamplemodifiedexitmemberKLSA2NE1inthe&thilev.
TLSSAMPlibrary.
3.
Assembleandlinkeditthenewlycreatedexitintothe&rhilev.
RLSLOADtargetlibrary.
4.
Createaspecialdialoginthe&rhilev.
RLSPNLSdatasetthatchecksonlytheuserID.
Formoreinformation,refertothecommentsprovidedinsampleexitmemberKLSA2NE1inthe&thilev.
TLSSAMPlibrary.
ImportantThesecurityexitisnotdrivenduringsplitwindowinitialization.
ImplementingGroupProfileswithACF2Chapter10.
NetworkAccessManager127ValidatingOnlytheACF2UserID128IBMCL/SuperSessionforz/OSCustomizationGuideChapter11.
NetworkAccountingFacilityTheNetworkAccountingFacility(NAF)keepsaccountingandauditrecordsattheselevels:vuservterminalvapplicationvsessionTherecordsmaybedirectedeithertoaBSAMjournaldatasetortotheactiveSystemManagementFacility(SMF)dataset.
CT/EnginemustbeAPF-authorizedforSMFrecording.
YoucanusetheNAFdatato:vmonitorapplicationandnetworkresourceusagevevaluatesystemsecuritymeasuresvperformnetworkplanningandcapacitymanagementvprovideinputfornetworkbillingCL/SuperSessiongeneratesNAFrecords.
NAFStartupParametersDuringCL/SuperSessioninitialization,theKLVINNAFmemberoftheinitializationlibrary(&rhilev.
RLSPARM)providesNAFstartupparameters.
TheformatoftheKLVINNAFparametersisshownbelow.
Allparametersmustbeprovidedasasinglelogicalstatement.
[DSNAME=dsname][BLKSIZE=nnnnn|3120][BUFNO=n|4][MOD][SMF=nnn]DSNAMEIdentifiesasequentialBSAMdatasetinwhichNAFrecordsaretobekept.
ThedatasetmusthavetheDCBattributesshownbelow.
Allotherfilecharacteristicsaresuppliedinternally.
DCB=(DSORG=PS,RECFM=U)IfDSNAMEisomittedandSMFisspecified,journalrecordsarewrittendirectlytotheactiveSMFdataset.
IfbothDSNAMEandSMFareomitted,norecordsarewritten.
BLKSIZESpecifiestheblocksizeforrecordsinadedicatedjournaldataset.
Thisoperandisoptional.
Valuesbetween287and32767arevalid.
Thedefaultis3120.
BUFNOSpecifiesthenumberofbuffersreservedfortheBSAMaccessmethodwithadedicatedjournaldataset.
Thisoperandisoptional.
Valuesbetween1and99arevalid.
Thedefaultis4.
CopyrightIBMCorp.
1997,2015129MODSpecifiesthatNAFrecordingshouldbeginafterthelastrecordalreadywrittentotheNAFdataset.
IfyouusetheBSAMaccessmethodandomitMOD,recordingbeginsatthebeginningofthedatasetandoverwritestheexistingcontents.
MODisvalidonlyforBSAM;itisnotvalidforSMFrecording.
SMFSpecifiesSMFrecordtype.
CT/EnginemustbeAPF-authorizedforSMFrecording.
Valuesbetween128and255arevalid.
IfSMFisnotspecified,noSMFrecordsarewritten.
$NAFRMacroYoucanusethe$NAFRmacroinmemberKLV$$MACintheTGMACLIBlibrarytogenerateaDSECTthatdefinestheformatoftheNAFrecords.
Byusingthedateandtimestampsprovidedineachrecordheader,youcansorttherecordsbydate,time,anduserIDtocorrelateallrecordsforaspecificuser'ssession.
FordetailedinformationonNAFrecordformats,see"NAFRecordLayouts"onpage132.
label$NAFRtype,X[DSECT=YES|NO],X[PREFIX=YES|NO]labelSpecifiesathree-characterlabeltowhichstandardrecordfieldnamesareappended.
Thisoperandallowsmanyexpansionsof$NAFRinasingleassembly.
ThedefaultlabelprefixisNAF.
typeIdentifiestheNAFrecordtype.
See"NAFRecordTypes.
"DSECTSpecifieswhetherornotaDSECTstatementshouldbegenerated.
Ifnot,aDSstatementforcingdoublewordalignmentisgenerated.
Ineithercase,thelabelfieldconsistsofcccDSECT(wherecccisathree-characterlabel).
Whendefaultsareused,aDSECTnamedNAFDSECTisgenerated.
ThedefaultisDSECT=YES.
PREFIXSpecifieswhetherornottheCT/Enginerecordheadersectionwillbeincluded.
NAFrecordsgenerallyincludethisprefixarea.
Thedefaultvalue,PREFIX=NO,suppressestheprefix.
NAFRecordTypesThissectiondescribestheNAFrecordtypesforCL/SuperSession.
Thekeywordusedtoidentifyeachrecordtypeisspecifiedinthetypeoperandofthe$NAFRmacro,togenerateanassemblerlanguagemappingoftherecord.
CL/SuperSessionRecordTypesSTARTUPSubtype00:SystemstartupGeneratedatCT/EnginestartuptoaccountfortheperiodoftimethatCT/Engineisactiveinthesystem.
SHUTDOWNSubtype01:SystemshutdownGeneratedatCT/EngineshutdowntoaccountfortheperiodoftimethatCT/Engineisactiveinthesystem.
EVRSubtype02:EntryvalidationNAFStartupParameters130IBMCL/SuperSessionforz/OSCustomizationGuideGenerateduponreturnfromNAM,wheninvokedtovalidatethenetworkaccessattemptedbytheuser.
IfNAMisnotactiveinthesystem,norecordingisperformed.
TheinformationincludestheNAMaccessrecommendation.
VSSULGNSubtype224:CL/SuperSessionentryGeneratedwhenauserestablishesasessionwithCL/SuperSession,afterVSSENTRYisexecuted.
TheCL/SuperSessionentryandexitrecordscontaintheuserID,physicalterminalID,andthelogicalunitnameoftheentrypointDIALOGAPPL.
VSSULGFSubtype225:CL/SuperSessionexitGeneratedwhenauserlogsofforisdisconnected,orwhenthecontroldialogterminates.
VSSTLGNSubtype226:VirtualsessioninitiationGeneratedwhenanewvirtualsessionisestablished.
ThevirtualsessioninitiationandterminationrecordscontaintheuserID,theapplicationsessionlogicalunitname,thevirtualterminallogicalunitname,andauniquesessionresourceidentification.
VSSTLGFSubtype227:VirtualsessionterminationGeneratedwhenavirtualsessionisterminated.
Thisrecordcontainstheinformationmentionedinthevirtualsessioninitiationrecord.
GWLOGONSubtype240:CL/SuperSessionlogonGeneratedwhenauserestablishesasessionwithagateway.
ThisrecordisnotdependentupontheacceptanceoftheuserbyNAMoranothersecuritysystem.
GWLOGOFFSubtype241:CL/SuperSessionlogoffGeneratedwhentheuserlogsoffthegateway.
GWPTSTRTSubtype244:CL/SuperSessionvirtualsessionstartedIndicatesthataSINGLEsessionwasstartedbetweentheuserandtheselecteddestinationapplication.
Theinformationincludesthedestinationapplicationnameandthelogicalunitnameofthevirtualterminaldeviceselected.
GWPTSTOPSubtype245:CL/SuperSessionvirtualsessionendedIndicatesthataSINGLEsessionbetweentheuserandtheselecteddestinationapplicationwasterminated.
Theinformationincludesthedestinationapplicationnameandthelogicalunitnameofthevirtualterminaldevicereleased.
CL/SuperSessionRecordTypesChapter11.
NetworkAccountingFacility131NAFReporting&rhilev.
RLSSAMPcontainsJCLandsourceprogramsthatyoucanusetoprovideaformattedlistingoftheNAFjournaldataset.
IfSMFrecordingisused,youcanrunthereportagainstanunloadedSMFfile,includingonecreatedbyIFASMFDP.
TheKLS@NAFmemberof&rhilev.
RLSSAMPcontainsasampleJCLprocedureanddescribesstepstakentoinstallandexecutetheKLS@NAFreportprogram.
Youcanusetheparametersdescribedbelowtocontrolthescopeandformatofthereport.
EnterthedesiredparametersintheSYSINfileoftheNAFreportprogram.
Note:IfyouuseSMFrecording,youmustchangetheSYSINE15DDstatementtoindicatethatSMFinputwillbeused.
DATE(begdate,enddate)Specifiesthebeginningandendingdatesoftherangeofrecordstoprocess.
Specifydatesindd/mm/yyformat.
IftheDATEparameterisomitted,allNAFrecorddatesencounteredintheinputfileareprocessed.
TIME(begtime[,endtime])Specifiesthebeginningandendingtimesoftherangerecordstoprocess.
Specifytimesinhh:mm:ssformat.
IftheTIMEparameterisomitted,allNAFrecordtimesencounteredintheinputfileareprocessed.
TYPE(type1,.
.
.
,typen)Specifiestherecordtypecodesoftherecordsdesired.
IftheTYPEparameterisomitted,allNAFrecordtypesareprocessed.
COUNT(nn)Specifiesthenumberoflinesperpagetobegeneratedinthereport.
IftheCOUNTparameterisomitted,thedefaultvalueof50linesperpageisused.
ExampleThisexampleassumesthatyouareinterestedindeterminingthenumberofusershandledbyCT/Engineinafive-dayperiod.
TheparametersshownbelowselectallEntryValidation(EVR)recordsgeneratedbetweenMarch21,1993andMarch25,1993.
Thereportisprintedusingthedefaultvalueof50linesperpage.
DATE(03/21/93,03/25/93)TYPE(EVR)NAFRecordLayoutsThe$NAFRmacro,whichgeneratesthe$NAFRDSECT,providesassemblerlanguagemappingofeachrecordlayout.
YoumustrefertothisDSECTwheneveryouusetheNAFreportingfacilityorwriteacustomNAFanalysis/reportingprogramtoobtainfieldlabelsanddetailedrecordstructures.
NAFrecordsaregroupedintoblocks.
TheNAFblockisthebasicunitoftransferbetweentheCT/EngineNAFrecorderandtheBSAMorSMFjournaldataset.
Eachrecordblockcontainsan18-byteSMF-compatibleheadersection,asdescribedintheIBMmanualOS/VS2MVSSPLSystemManagementFacility.
TherecordtypedefinedbytheKLVINNAFSMFparameterresidesinthissection.
TheSMFheadersectionisalsopresentinNAFblockswhenyouusetheBSAMaccessmethod.
TheSMFheadersectionisfollowedbyoneormoreNAFrecords.
EachNAFrecordconsistsofafixed-lengthprefixsectionandarecord-dependentsection.
NAFReporting132IBMCL/SuperSessionforz/OSCustomizationGuideMemberKLSNAF15of&rhilev.
RLSSAMPcontainsthesourcecodeforaroutinethatreconstructsindividualrecordscontainedinaNAFblock.
ThesamplesourceroutineisasortinputexitroutinethatpassesdeblockedrecordstotheSORTutility.
Eachrecordproducedbythesortcontainsthe18-byteSMFheader,followedbytheNAFrecord.
MemberKLSNAFPTof&rhilev.
RLSSAMPcontainsabasicNAFreportprogramthatillustratesthelayoutofaNAFrecordblockandtheuseofthe$NAFRmappingmacro.
Theoutputfromthesortutilityisusedasinputtotheprintroutine.
ThefollowingtableshowstheformatoftheNAFprefix,whichisincludedineachrecord.
FieldNameOffsetsLengthFormatDescriptionRTYPE01binaryRecordsubtype:Hex:00=Startuprecord(10bytes)01=Shutdownrecord(10bytes)02=Entryvalidationrecord(219bytes)E0=CL/SuperSessionuserlogon(34bytes)E1=CL/SuperSessionuserlogoff(34bytes)E2=CL/SuperSessionterminallogon(38bytes)E3=CL/SuperSessionterminallogoff(72bytes)F0=CL/SuperSessionlogon(34bytes)F1=CL/SuperSessionlogoff(34bytes)F4=CL/SuperSessionSINGLEstart(50bytes)F5=CL/SuperSessionSINGLEstop(50bytes)RTIME1-44binaryTimestamp(TODclock)RDATE5-62binaryDatestamp:JulianyearRDATE7-82packeddecimalDatestamp:JuliandayRLEN91binaryVariabledatalengthSTARTUPRecordThisrecordisgeneratedatCT/EnginestartuptoaccountfortheperiodoftimethatCT/Engineisactiveinthesystem.
Itslengthis10bytes.
FieldNameOffsetsLengthFormatDescriptionRTYPE01binaryHex:00=Startuprecordsubtype(10bytes)NAFRecordLayoutsChapter11.
NetworkAccountingFacility133FieldNameOffsetsLengthFormatDescriptionRTIME1-44binaryTimestamp(TODclock)RDATE5-62binaryDatestamp:JulianyearRDATE7-82packeddecimalDatestamp:JuliandayRLEN91binaryHex:00=VariabledatalengthSHUTDOWNRecordThisrecordisgeneratedatCT/EngineshutdowntoaccountfortheperiodoftimethatCT/Engineisactiveinthesystem.
Itslengthis10bytes.
FieldNameOffsetsLengthFormatDescriptionRTYPE01binaryHex:01=ShutdownrecordsubtypeRTIME1-44binaryTimestamp(TODclock)RDATE5-62binaryDatestamp:JulianyearRDATE7-82packeddecimalDatestamp:JuliandayRLEN91binaryHex:00=VariabledatalengthEntryValidationRecordThisrecordisgeneratedwhentheNetworkAccessManager(NAM)attemptstovalidatenetworkaccess.
IfNAMisnotactiveinthesystem,norecordingisperformed.
Itslengthis219bytes.
FieldNameOffsetsLengthFormatDescriptionRTYPE01binaryHex:02=EntryvalidationrecordsubtypeRTIME1-44binaryTimestamp(TODclock)RDATE5-62binaryDatestamp:JulianyearRDATE7-82packeddecimalDatestamp:JuliandayRLEN91binaryHex:D1,Decimal:209VariabledatalengthRC101binaryReturncodeACTCP11-188characterActivecontrolpointnameUSER19-279characterLength/userIDGROUP28-369characterLength/groupACCT37-182146characterCount/length/accountPROC183-1919characterLength/PROCTERM192-2009characterLength/TERMSTARTUPRecord134IBMCL/SuperSessionforz/OSCustomizationGuideFieldNameOffsetsLengthFormatDescriptionAPPL201-2099characterLength/APPLREQCP210-2189characterLength/requestedcontrolpoint(VSSULGN)CL/SuperSessionUserLogonThisrecordisgeneratedwhenauserestablishesasessionwithCL/SuperSession.
Itslengthis34bytes.
FieldNameOffsetsLengthFormatDescriptionRTYPE01binaryHex:E0,Decimal:224SSuserlogonsubtypeRTIME1-44binaryTimestamp(TODclock)RDATE5-62binaryDatestamp:JulianyearRDATE7-82packeddecimalDatestamp:JuliandayRLEN91binaryHex:18,Decimal:24VariabledatalengthAPPL10-178characterVTAMapplicationname(leftjustified)LU18-258characterVTAMlogicalunit(leftjustified)USER26-338characterUserID(leftjustified)(VSSULGF)CL/SuperSessionUserLogoffThisrecordisgeneratedwhenauserlogsofforisdisconnected,orwhenthecontroldialogisterminated.
Itslengthis34bytes.
FieldNameOffsetsLengthFormatDescriptionRTYPE01binaryHex:E1,Decimal:225SSuserlogoffsubtypeRTIME1-44binaryTimestamp(TODclock)RDATE5-62binaryDatestamp:JulianyearRDATE7-82packeddecimalDatestamp:JuliandayRLEN91binaryHex:18,Decimal:24VariabledatalengthAPPL10-178characterVTAMapplicationname(leftjustified)LU18-258characterVTAMlogicalunit(leftjustified)USER26-338characterUserID(leftjustified)EntryValidationRecordChapter11.
NetworkAccountingFacility135(VSSTLGN)CL/SuperSessionVirtualTerminalLogonThisrecordisgeneratedwhenanewvirtualsessionisestablished.
Itslengthis38bytes.
FieldNameOffsetsLengthFormatDescriptionRTYPE01binaryHex:E2,Decimal:226SSterminallogonsubtypeRTIME1-44binaryTimestamp(TODclock)RDATE5-62binaryDatestamp:JulianyearRDATE7-82packeddecimalDatestamp:JuliandayRLEN91binaryHex:1C,Decimal:28VariabledatalengthUSER10-178characterUserID(leftjustified)PLU18-258characterVirtualprimarylogicalunit(leftjustified)SLU26-338characterVirtualsecondarylogicalunit(leftjustified)LRN34-374binarySessionresourceIDForSMFstatistics,sessionswitchesaredeterminedbycountingthenumberoftimesthevirtualterminalbufferisREFRESHed.
ThismeansthatwhenaREFRESHoccurs,itiscountedasasessionswitch.
Hence,anIMBRCSTsavesthevirtualterminalbufferandthenREFRESHesitwhenthemessageiserasedfromtheterminal.
Thiscreatesaninvalidsessionswitchcounter.
Rememberthatwhenyouinitiallylogon,thevirtualterminalisnotREFRESHed;itiscreated.
SotheLOGONcountisincreased,butthesessionswitchcountisnot.
(VSSTLGF)CL/SuperSessionVirtualTerminalLogoffThisrecordisgeneratedwhenavirtualsessionisterminated.
Itslengthis88bytes.
FieldNameOffsetsLengthFormatDescriptionRTYPE01binaryHex:E3,Decimal:227SSterminallogoffsubtypeRTIME1-44binaryTimestamp(TODclock)RDATE5-62binaryDatestamp:JulianyearRDATE7-82packeddecimalDatestamp:JuliandayRLEN91binaryHex:4E,Decimal:78VariabledatalengthUSER10-178characterUserID(leftjustified)PLU18-258characterVirtualprimarylogicalunit(leftjustified)SLU26-338characterVirtualsecondarylogicalunit(leftjustified)LRN34-374binarySessionresourceID(VSSTLGN)CL/SuperSessionVirtualTerminalLogon136IBMCL/SuperSessionforz/OSCustomizationGuideFieldNameOffsetsLengthFormatDescriptionVLU38-458characterVTAMlogicalunit(leftjustified)ACCLNINMSGINCNTOTCNTOTMSGRFMSGRFCNTUPMSGUPCNTTIMSGTICNT46-8724444444444binarybinarybinarybinarybinarybinarybinarybinarybinarybinarybinaryLengthofaccumulatorarrayisvariablefrom2-40bytesandmayincludethefollowing:Inboundmessagecount(APPLtoSS)Inboundbytecount(APPLtoSS)Outboundbytecount(SStoAPPL)Outboundmessagecount(SStoAPPL)Refreshmessagecount(SStoTERM)Refreshbytecount(SStoTERM)Updatemessagecount(SStoTERM)Updatebytecount(SStoTERM)TerminalinputmessagecountTerminalinputbytecountIfdatacompressionison,youcancalculate(ABS(UPCNT-INCNT))*100/INCNTandinboundcompressionefficiencybydividingoutboundbytecountbyterminalinputbytecount:OTCNT/TICNT(GWLIMIT)CL/SuperSessionRecordThisrecordisgeneratedwhenthelimithasbeenreachedforresolvingadataelement.
FieldNameOffsetsLengthFormatDescriptionRTYPE01binaryHex:F3,Decimal:243GatewaylimitreachedAPPL1-88characterVTAMapplicationname(leftjustified)LU9-168characterVTAMlogicalunit(leftjustified)USER17-248characterUserID(leftjustified)DATA25-328characterDataelement(leftjustified)(VSSTLGF)CL/SuperSessionVirtualTerminalLogoffChapter11.
NetworkAccountingFacility137(GWLOGON)CL/SuperSessionLogonThisrecordisgeneratedwhenauserestablishesasessionwithCL/SuperSession.
Itslengthis34bytes.
FieldNameOffsetsLengthFormatDescriptionRTYPE01binaryHex:F0,Decimal:240GatewaylogonRTIME1-44binaryTimestamp(TODclock)RDATE5-62binaryDatestamp:JulianyearRDATE7-82packeddecimalDatestamp:JuliandayRLEN91binaryHex:F3Decimal:243GatewaylimitreachedAPPL10-178characterVTAMapplicationname(leftjustified)LU18-258characterVTAMlogicalunit(leftjustified)USER26-338characterUserID(leftjustified)(GWLOGOFF)CL/SuperSessionLogoffThisrecordisgeneratedwhenauserlogsoffCL/SuperSession.
Itslengthis34bytes.
FieldNameOffsetsLengthFormatDescriptionRTYPE01binaryHex:F1,Decimal:241GatewaylogoffRTIME1-44binaryTimestamp(TODclock)RDATE5-62binaryDatestamp:JulianyearRDATE7-82packeddecimalDatestamp:JuliandayRLEN91binaryHex:18,Decimal:24VariabledatalengthAPPL10-178characterVTAMapplicationname(leftjustified)LU18-258characterVTAMlogicalunit(leftjustified)USER26-338characterUserID(leftjustified)(GWPTSTRT)CL/SuperSessionSINGLEStartThisrecordindicatesthataSINGLEsessionwasstartedbetweentheuserandtheselecteddestinationapplication.
Itslengthis50bytes.
FieldNameOffsetsLengthFormatDescriptionRTYPE01binaryHex:F4,Decimal:244GatewaySINGLEstartsubtype(GWLOGON)CL/SuperSessionLogon138IBMCL/SuperSessionforz/OSCustomizationGuideFieldNameOffsetsLengthFormatDescriptionRTIME1-44binaryTimestamp(TODclock)RDATE5-62binaryDatestamp:JulianyearRDATE7-82packeddecimalDatestamp:JuliandayRLEN91binaryHex:28,Decimal:40VariabledatalengthAPPL10-178characterVTAMapplicationname(leftjustified)LU18-258characterVTAMlogicalunit(leftjustified)USER26-338characterUserID(leftjustified)VLU34-418characterVirtualLU(leftjustified)DEST42-498characterDestinationLU(leftjustified)(GWPTSTOP)CL/SuperSessionSINGLEStopThisrecordindicatesthataSINGLEsessionwasterminated.
Itslengthis50bytes.
FieldNameOffsetsLengthFormatDescriptionRTYPE01binaryHex:F5,Decimal:245GatewaySINGLEstopsubtypeRTIME1-44binaryTimestamp(TODclock)RDATE5-62binaryDatestamp:JulianyearRDATE7-82packeddecimalDatestamp:JuliandayRLEN91binaryHex:28,Decimal:40VariabledatalengthAPPL10-178characterVTAMapplicationname(leftjustified)LU18-258characterVTAMlogicalunit(leftjustified)USER26-338characterUserID(leftjustified)VLU34-418characterVirtuallogicalunit(leftjustified)DEST42-498characterVTAMdestinationLU(leftjustified)(GWPTSTRT)CL/SuperSessionSINGLEStartChapter11.
NetworkAccountingFacility139(GWPTSTOP)CL/SuperSessionSINGLEStop140IBMCL/SuperSessionforz/OSCustomizationGuideChapter12.
CL/SuperSessionStartupParametersThischapterdiscusses:vThelocationofCL/SuperSessionparameterstooverridevConsiderationsforcalculatingavaluefortheMINIMUMparametervConsiderationsforusingtheQUIESCEparametervTheCL/SuperSessioninitializationandcustomizationparametersinalphabeticorderLocatingParameterstoOverrideDefaultstartupparametervaluesforCL/SuperSessionaredefinedinmemberKLSSYSINof&rhilev.
RLSPARM.
Tooverridetheseparametersatinitializationtime,codeyourparametersinKLSSYSINortheEXECPARMfieldoftheJCL.
JCLparameterstakeprecedenceoverKLSSYSIN.
IfyouwanttooverridevaluesforCL/SuperSession,besuretousememberKLSSYSINoftheRLSPARMlibrary,eventhoughtheparametersdescribedbelowmayrefertoTLVSYSINandTLVPARM.
ImportantChangestothestartupparametersmayadverselyaffectCL/SuperSessionperformance.
CalculatingMINIMUMIfyouwanttouseextendedstorage,youmustcodeanon-zerovaluefortheMINIMUMparameter,orallowMINIMUMtodefault.
TodeterminethebestvalueforMINIMUM,usethefollowingformula:2048K+(#users*((#sess/user*screen_size*eab)+20K))*1/82048KMinimumstorageCT/Enginemusthavetoload.
#usersNumberofsimultaneoususers.
#sess/userNumberofactivesessionsperuser.
screen_sizeWidthofscreenmultipliedbylengthofscreen.
Forexample,a3270MOD2terminalwouldhaveascreen_sizevalueof(24*80)=1920.
eabOneofthefollowing:1NoEABsupport.
2EABsupport.
20KVariableandTablestorage.
1/8Specifiesthat1/8thofallusersmustbeabletobeloggedontoCL/SuperSessionatthesametime.
Note:Repeat(#sess/user*screen_size*eab)intheformulaforeachdifferentscreensizeandEAB.
CopyrightIBMCorp.
1997,2015141Approximately32Kperuserallowseither3EABModel2sessionsor6non-EABsessions.
ForModel4andModel5,42Kperuserallowseither3EABModel2sessionsor6non-EABsessions.
FormoreinformationabouttheMINIMUMparameter,refertothealphabeticlistofCL/SuperSessionstartupparametersonthefollowingpages.
UsingQUIESCETheQUIESCElimithasdifferentaffectsonCARVEDandFREEstoragechecking.
IfyouignoreCARVEDstoragechecks(accomplishedbycodingQUIESCE(0,C)inyourSYSINmember)anabendmayoccurwithoutwarningmessages.
Ifyoucodeacarvedstoragelimit,oncethatpercentageofstoragehasbeencarved,warningmessageswillalertyouthatQUIESCEModeisineffect.
Thisallowsyoutonotifyusersandperformnecessaryshutdownprocedures.
BecauseCARVEDQUIESCEmodeisterminal,CL/SuperSessionwillnothonornewsessionrequestsregardlessofhowmuchstorageisFREE.
InCARVEDQUIESCEmodeanabendmaystilloccurifarequestforstorageismadefromuserscurrentlyloggedonthatcannotbehonoredbytheamountthatwasleftreserved.
AFREEquiesceconditionisrecoverable.
Storageallocatedtousersessionsisfreedasuserslogoffactiveapplicationsorcompletedialogfunctionsthatrequireavirtualsession.
Assoonastheamountofstorageinusedropsbelowtherecoverypoint,thequiesceconditionisrelieved.
IfyouignoreFREEstoragechecksbycodingQUIESCE(0,F)inyourKLSSYSINmemberandallofyourallocatedstorageisinusewhenarequestforadditionalstorageismade,anabendconditionwilloccur.
Ifyoucodeafreestoragelimit,oncethatpercentageofstorageisinuse,warningmessageswillalertyouthatquiescemodeisineffect.
Thisconditionwillcontinueonlyaslongasstorageremainsexhausted.
Youcanminimizefreestorageexhaustionbypreallocatingthesmallblocksizesintopoolsofallonesizecarvedcontiguously.
See"StoragePreallocation"onpage164formoreinformation.
Ifeithercarvedorfreequiescelimitisreached,reviewstoragetotalsandcheckMINIMUMandMAXIMUMvalues.
AfterreviewingthestoragetotalsyoumayneedtoincreaseMINIMUMorMAXIMUMvalues.
Itisrecommendedthatyouallocateenoughstoragetoincludeasmallbufferabovethequiescethresholdsothatuserprocessingisnotinterrupted.
FormoreinformationabouttheQUIESCEparameter,refertothealphabeticlistofCL/SuperSessionstartupparametersonthefollowingpages.
CL/SuperSessionStartupParametersCL/SuperSessionstartupparametersaredefinedwithappropriatedefaultsinmemberTLVSYSINofTLVPARM.
CL/SuperSessionstartupparametersspecifytheexecutionandresourcemanagementenvironment.
CalculatingMINIMUM142IBMCL/SuperSessionforz/OSCustomizationGuideYoumayoverridecertainCL/SuperSessionoperatingparametersatinitializationtimebycodingtheparametersinTLVSYSINortheEXECPARMfieldoftheJCL.
JCLspecificationPARMsoverrideTLVSYSINparameters.
AMODE31AMODE31(Y|N)DetermineswhetherCL/SuperSessionrunsin31-bitaddressingmode.
YisthedefaultforMVS/XAandMVS/ESA.
NisthedefaultforMVS/SP.
IfMVS/XAisrunningunderVTAMpriortoVersion3.
1.
1orDFPpriortoVersion1.
2,codethefollowing:AMODE31(N)APFAPF(Y|N)DetermineswhetherCL/SuperSessionrunsasAPF-authorized.
YisthedefaultiftheCT/EnginejobstepisAPF-authorized;otherwise,Nisthedefault.
Note:IfyouspecifyY,theCL/SuperSessionjobstepmustbeAPF-authorized.
CONFIRMCONFIRM(15|n)SetsthemaximumnumberofsecondsbetweentwosuccessiveSHUTDOWNcommandsorMVSSTOP(P)commandstoterminatetheCL/SuperSessionaddressspace.
CONFIRM(0)allowsCL/SuperSessionshutdowntobeginimmediatelywithoutanadditional,confirmingSHUTDOWNcommand.
CONFIRM(n)preventsaccidentalshutdownsbyrequiringyoutoconfirmthecommandbyenteringitasecondtimewithinthespecifiednumberofseconds.
Forexample,thedefault(15)requiresyouenterSHUTDOWNtwicewithin15secondstoterminatetheCL/SuperSessionaddressspace.
CONSECHOCONSECHO(N|Y)DetermineswhetherCL/SuperSessioncommandoutputisroutedbacktotheoriginatingz/OSoperatorconsole.
NcausesalloutputfromcommandsissuedviatheMVSMODIFYcommandorsubsystemconsolestoberoutedonlytothemasterconsoleandthoseconsoleswhicharereceivingtheappropriatez/OSroutecodes.
Ycausesthecommandoutputtoberoutedspecificallytotheoriginatingconsole,aswellasthemasterandotherconsoles.
BycodingY,productssuchasNetViewandSystemAutomationtoolsareabletoreviewtheoutputofCL/SuperSessioncommands.
CL/SuperSessionStartupParametersChapter12.
CL/SuperSessionStartupParameters143DATEFMTDATEFMT(MMDDYY|DDMMYY|YYMMDD)SpecifiestheformatofdatesdisplayedbyCT/Engineinthe&SYSDATEdialogvariable.
Possiblevaluesare:MMDDYYU.
S.
formatDDMMYYEuropeanformatYYMMDDInternationalformatDEBUGImportantDonotmodifythisparameterexceptundertheguidanceofanIBMsupportrepresentative.
DEBUG(N|Y)SpecifyYtousethedebugoptionforresolvinginternalproblems.
DEBUG(Y)automaticallyturnsontheinternaltracewiththedefaultnumberofentries(1024).
See"TRACE"onpage153formoreinformation.
DEBUG(Y)willcauseanincreaseinCPUandstorageuse,aswellastheissuanceofmoremessages.
Theamountoftheincreasedependsontheactivitywithintheaddressspace.
INBDLIMINBDLIM(25|n)SpecifiesthemaximumnumberofmessagesthatcanbequeuedforasessionbetweenanapplicationandCT/Engine.
Ifthisnumberisexceeded,thesessionterminates.
INBDLIMpreventsapplicationsfromfloodingCT/Enginewithmessages,whichcausesCT/Enginetorunshortofstorageandabend.
Byspecifyingalargevalue,anapplicationthatsendsmanyoutbounddatastreamstoaterminalwithoutrequestinginputcancauseCT/Enginetoabend,evenifdefiniteresponseisnotspecifiedforthesession.
Mostfiletransferprogramsimplementhandshakingprotocolsthatrequirethemtoperformreadoperations.
TheseprogramsshouldnotbeaffectedbyasmallINBDLIMvalue.
Note:INBDLIMlimitsthenumberofmessagesanapplicationsendstoCT/Engine(thevirtualterminal).
OUTBDLIMlimitsthenumberofmessagesCT/Enginesendstothephysicalterminal.
INBOUNDINBOUND(248|n)SpecifiesthesizeofallVTAMRECEIVEbuffers,regardlessoforigin.
DATEFMT144IBMCL/SuperSessionforz/OSCustomizationGuideIfthelengthofareceivedRUislargerthanthevalueassignedtoINBOUND,excesspathlengthsresult.
IfthevalueassignedtoINBOUNDismuchlargerthanthelengthoftheRUsreceived,storageproblemsmayresult.
IfyouarerunningaboveVTAM1.
3,donotmodifytheINBOUNDparameter.
INITIALINITIAL(membername)Identifiesthecommandlist(CLIST)thatcontainsCT/Engineinitializationcommands.
Thereisnohard-codeddefault.
TLVPARM(TLVSYSIN)containsINITIAL(KLVSTART),whichinvokestheKLVSTARTmemberofTLVCMDS.
TLVCMDSmaycontainamembernamedsmfid,wheresmfidistheSMFIDoftheCPUexecutingCT/Engine.
Ifthismemberexists,itisautomaticallyinvokedbeforethecommandlistspecifiedintheINITIALparameter.
INITLISTINITLIST(membername)IdentifiesthememberofTLVPARMwhichcontainsinitializationmembernameoverrides.
Normally,CT/EngineinitializationmodulesreadmembersofTLVPARMwhosenamesarethesameasthemodules.
ThememberidentifiedbytheINITLISTkeywordcontainsstatementssuchas:startup-module-name=override-nameEachlineoftheINITLISTmembernamesaparticularstartupmoduleandidentifiesthememberofTLVPARMwhichshouldbereadbythatmoduleforitsparameters.
ThevalidstartupmodulenamesvarywiththeCT/Engine-basedproductsthatareinstalled.
Thenumberofstartupmodulesmayalsochangeasnewfeaturesareaddedornewproductsbecomeavailable.
Asaresult,itisnotpossibletoprovideacomprehensivelistofstartupmodulenames.
Nowild-cardcharactersareacceptedduringINITLISTprocessing.
Eachoverridemustbecodedinfull.
Overridestatementsmustbecodedoneperline.
Thestatementsmayappearinanycolumn.
Inputwillbeconvertedtouppercasepriortoprocessing.
Commentlinesareindicatedbyanasteriskasthefirstnon-blankcharacter.
Onanyline,anythingfollowinganasteriskisignored.
Hereisasampleinputline:KLVINNAM=NAMINIT0*OverrideKLVINNAMparametermembernameIfmultipleoverridestatementsforthesamestartupmodulearepresent,thelastonewilldeterminethemembernametobeused.
Nomessageswillbeissued.
TLVPARMmaycontainamembernamedsmfid,wheresmfidistheSMFIDoftheCPUexecutingCT/Engine.
Ifthismemberexists,itwillbeusedasthelistofinitializationmembernameoverridesiftheINITLISTkeywordisnotcoded.
WhenINITLISTiscoded,amemberofTLVPARMnamedsmfidwillnotbereadevenifpresentinthelibrary.
INBOUNDChapter12.
CL/SuperSessionStartupParameters145INTLCHARINTLCHAR(N|Y)Implementsthefollowingnationallanguagesupportfeatures:1.
Thewindowverticalbarcharacter(|)ischangedfromX'6A'toX'4F'.
2.
Characterswithdiacriticalmarksthatwerepreviouslyinterpretedasinvalidarenowvalid.
LIMITImportantDonotmodifythisparameterexceptundertheguidanceofanIBMsupportrepresentative.
LIMIT(16,P|n,P)LIMIT(16,X|n,X)Specifiesthelargestblockofprimary(P)orextended(X)storagethatcanbeallocated.
Thisvalueisspecifiedinbytes,asapowerof2.
Forexample,ifnis16,thelargestblockthatcanbeallocatedis65,536bytes.
Primarystorageisbelowthe16-megabyteline;extendedstorageisabovetheline.
Tospecifyvaluesforbothprimaryandextendedstorage,includetheLIMITparametertwiceinTLVSYSIN:LIMIT(n,X)LIMIT(n,P)IftheLIMITvalueistoosmallandaprocessinCT/EngineattemptstoallocateablockofstoragelargerthanLIMITspecifies,programinterruptionU0100orU0200results.
ToolargeaLIMITvaluemaywastestorageandincreaseprocessingoverhead.
LOGBLOCKLOGBLOCK(3120|n)Specifies,inbytes,theblocksizeoftheCT/EngineTLVLOGfile.
LOGBUFSImportantDonotmodifythisparameterexceptundertheguidanceofanIBMsupportrepresentative.
LOGBUFS(2|n)SpecifiesthenumberofbufferstoallocatefortheCT/EngineTLVLOGfile.
IfthevalueofLOGBUFSissmallandextensiveloggingisperformed(forexample,duringdebugging),CT/EngineresponsemaysufferbecauseofexcessivephysicalI/O.
IfthevalueofLOGBUFSislarge,storageshortagesmayoccur.
LSRPOOLLSRPOOL(size,count[0|hiper])Nodefault;however,youmustcodeatleastoneLSRPOOLparameterinorderforCT/Enginetostart.
INTLCHAR146IBMCL/SuperSessionforz/OSCustomizationGuideCorrespondstotheBUFFERSparameteroftheBLDVRPmacroinstruction,andspecifiesthenumberofbufferstobemadeavailableforeachVSAMdatasetusedbyCT/Engine.
sizeisabuffer(VSAMcontrolinterval)size.
Validsizesare512,1024,2048,4096,8192,12288,16384,20480,24576,28672,and32768.
countisthenumberofvirtualstoragebuffersofsizetobeallocated.
Theminimumis3.
Themaximumis65535,althoughthismaybeless,dependingontheamountofavailablevirtualstorageintheCT/Engineaddressspace.
BufferswillbeallocatedfromextendedstorageifAMODE31(Y)wascodedordefaultedto;fromprimarystorageotherwise.
hiperisthenumberofhiperspacebuffersofsizetobeallocated.
Theminimumis0(nohiperspacebuffers).
Themaximumis16777215,althoughthismaybeless,dependingonthehiperspacestorageavailabletoIBMVSAMservices.
EnsuretheCT/Engineaddressspaceisnon-swappablewhenyouareusinghiperspacebuffers.
Note:IBMrestrictshiperspacebufferstomultiplesof4K.
Donotcodehiperforthe512,1024,or2048sizes;anerrormessagewillbeissuedandCT/Enginestartupwillterminate.
Forbeststorageuse,codeanLSRPOOLparameterforeachdifferentVSAMcontrolintervalsizethatCT/Engineuses:vindexbufferforNAMandtabledatabasevdatabufferforNAMandtabledatabasevdatabufferforVIEWLOGTherecommendedvaluesareprovidedinTLVPARM(TLVSYSIN).
Note:YoumustenterLSRPOOLsindividually;youcannotstringthem.
IfyoureceivemanyKLVVS026messagesidentifyingbuffercontention,increasethenumberofbuffersallocatedtothedatasetidentifiedintheassociatedKLVVS021messages.
LSRSTRNOLSRSTRNO(32|n)CorrespondstotheSTRNOparameteroftheBLDVRPmacroinstruction.
ItisthemaximumnumberofconcurrentVSAMrequeststhatCT/EnginecanprocessagainstalltheVSAMdatasetsallocatedtoit.
IfyoureceivemanyKLVVS026messagesidentifyingstringcontention,oriftheSTRMAXvalueintheKLVVS002messagesissuedduringCL/ENGINEshutdownisconsistentlythesameasthevalueinTLVSYSIN,increasetheLSRSTRNOvalue.
Theminimumvalueis1.
Themaximumis255.
MAXIMUMMAXIMUM(8192,P|n,P)MAXIMUM(n,X)LSRPOOLChapter12.
CL/SuperSessionStartupParameters147Thedefaultvalueforextendedstorage(X)isthevaluespecifiedbytheMINIMUMkeyword.
MAXIMUMisastoragethrottleusedtopreventGETMAINsfromoverallocatingandoccupyingthepagedatasetwithrarelyreferencedframes.
Thevariablenrepresentsthemaximumamount(inkilobytes)ofprimaryorextendedstoragethatcanbeallocated.
Xstandsforextendedstorage(abovethe16-megabyteline),andPstandsforprimarystorage(belowtheline).
SetyourMAXIMUMvaluetoavaluethatwillallowCT/Enginetocontinuerunningwithoutoverloadingyourpagevolumeswhenthesteady-stateMINIMUMvalueisexceeded.
Touseextendedstorage,youmustdobothofthefollowing:vCodetheMINIMUMparameter.
vMakesurethatMAXIMUMisequaltoorgreaterthanMINIMUM+RESERVE.
IfMAXIMUMistoolargeandRESERVEisnotlargeenoughtomeetyourrequirements,theaddressspacemayrunoutofvirtualstorage.
IfthevalueofMAXIMUMisgreaterthanthatofMINIMUM,CT/EngineattemptsaconditionalGETMAINfortheMAXIMUMvalueminustheRESERVEvalue(RESERVEdefaultsto512,P.
).
IftheMAXIMUMvalueisnotsatisfied,CT/EngineacceptstheamountofstorageacquiredbytheGETMAIN.
MINIMUMMINIMUM(1024,P|n,P)MINIMUM(8192,X|n,X)nrepresentsthemimimumamount(inkilobytes)ofprimaryorextendedstoragethatcanbeallocated.
Forexample,tospecifya16-megabyteabove-the-lineregion,codeMINIMUM(16384,X)Tospecifya32-megabyteabove-the-lineregion,codeMINIMUM(32768,X)Touseextendedstorage,youmustdobothofthefollowing:vCodetheMINIMUMparameter.
vMakesurethatMINIMUM+RESERVEislessthanorequaltoMAXIMUM.
Notethefollowingaboutthedefaultabove-the-lineregion:vSpecifiedintheIEFUSIandIEALIMITz/OSmodules.
vDistributedbyIBMas32megabytes.
vIfsmallerthantheamountspecifiedfortheMINIMUMparameter,dooneofthefollowing:–Alterthedefault.
–UsetheREGIONparameterasfollows:MAXIMUM148IBMCL/SuperSessionforz/OSCustomizationGuide0Kor0MAllprimaryandextendedstorageisavailableforGETMAIN.
Upto16MPrimaryregionequalsthespecifiedvalue;extendedregionequalsthedefault.
Upto32MAllavailableregiongoestoprimarystorage;extendedregionequalsthedefault.
Above32MAllavailableregiongoestoprimarystorage;specifiedvaluegoestoextendedstorage.
Ingeneral,itisrecommendedtosetREGION=0M.
OPLIMITOPLIMIT(0|n)SpecifiesthemaximumnumberofcharactersthatcanbequeuedtoasingleCT/Engineoperatorbeforethemessagesarebypassed.
Thedefault(0)isnolimit.
OPLOCALOPLOCAL(REPLY,ERROR|messagetype,messagetype,.
.
.
)Specifiesthetypesofmessagesanoperatorconsolereceivesinresponsetoactionsinitiatedbythatsameconsole.
WiththedefaultOPLOCALsetting,anoperatorperforminganactionthatgeneratesaCT/EngineALERTmessagedoesnotreceivethemessageattheconsoleunlessOPMASKallowsit.
OPMASKOPMASK(INFO,WARN,ALERT|messagetype,messagetype,.
.
.
)Specifiesthetypesofunsolicitedmessagesalloperatorconsolesreceive.
OPSTARTOPSTART(command)SpecifiesaninitialCT/EnginecommandorCLISTtobeissuedafteranoperatorlogson.
Thereisnodefault.
TLVPARM(TLVSYSIN)containsOPSTART(KLVOPST),whichinvokestheKLVOPSTmemberofTLVCMDS.
OUTBDLIMOUTBDLIM(500|n)SpecifiesthemaximumnumberofmessagesthatcanbequeuedforasessionbetweenCT/Engineandthephysicalterminal.
Ifthisnumberisexceeded,thesessionterminates.
MINIMUMChapter12.
CL/SuperSessionStartupParameters149ThepurposeofOUTBDLIMistopreventexcessivemessagesfromcausingCT/Enginetorunshortofstorageandabend.
IfyouspecifyaverylargevalueforOUTBDLIM,anapplicationthatsendsmanyoutbounddatastreamstoaterminalwithoutrequestinginputcancauseCT/Enginetoabend,evenifdefiniteresponseisnotspecifiedforthesession.
Note:OUTBDLIMlimitsthenumberofmessagesCT/Enginesendstothephysicalterminal.
INBDLIMlimitsthenumberofmessagesanapplicationsendstoCT/Engine(thevirtualterminal).
OUTBOUNDOUTBOUND(504|n)Specifies,inbytes,anoutboundRUbufferlengthforVTAMsessionsforwhichalengthisnotprovidedinthesessionparameters.
PACKImportantDonotcodethisparameterexceptundertheguidanceofanIBMsupportrepresentative.
CL/SuperSessionPACK(Y|N)DetermineshowCT/EngineloadsmodulesintotheCT/Engineregion:omittedSpecifiesthatmodulesareplacedintothenextavailabledoublewordstoragelocation.
IftheaddressspaceisAPF-authorized,anz/OSdirectedloadisusedandz/OSCDEsareavailable;otherwiseCT/Engineperformsapseudo-directedloadandnoCDEsarecreated.
YCT/Engineperformsapseudo-directedloadtoplacemodulesintothenextavailabledoublwordstoragelocation.
Noz/OSCDEsarecreated.
NModulesareloadedusingstandardz/OSLOADmacros.
z/OSCDEsarecreated.
MostCT/Engine-basedmodulesarelinkeditedonapageboundary;PACK(N)honorsthatboundary,andthereforewillrequirealargerCT/Engineregion.
QUIESCEQUIESCE(90,P,F|n,P,F)QUIESCE(95,P,C|n,P,C)QUIESCE(90,X,F|n,X,F)QUIESCE(95,X,C|n,X,C)Setsthresholdsforslowingdownallocationofstorage.
Whenthethresholdsareexceeded,quiescemodegoesintoeffect,causingrejectionofallconditionalstoragerequests.
Conditionalstoragerequestsincludesessionanddialogstartup,aswellasotherfunctionsthatcanrecoverfromastorageshortage.
Unconditionalrequestsforstoragecontinuetobesatisfiedinquiescemode.
Thevariablenrepresentsthepercentageofprimary(P)orextended(X),free(F)orcarved(C)storageallowedtobeallocatedbeforequiescemodetakeseffect.
Carvedstorageisstorageputintouseforthefirsttimeandallocatedtoaspecificsize;freeOUTBDLIM150IBMCL/SuperSessionforz/OSCustomizationGuidestorageisstoragethathasbeencarvedbutisnotinuse.
Primarystorageisbelowthe16-megabyteline;extendedstorageisabovetheline.
Avalueofzero(0)indicatesnoQUIESCEthreshold,whichmeansquiescemodenevergoesintoeffect.
Avalueof100indicatesthatallstoragemustbeusedorcarvedbeforequiescemodetakeseffect.
Tospecifythatquiescemodetakeseffectwhen80%ofthetotalamountofstorageisinuseinextendedstorage,enterthefollowing:QUIESCE(80,X,F)Tospecifythatquiescemodetakeseffectwhen90%ofthetotalamountofprimarystoragehasbeencarved,enterthefollowing:QUIESCE(90,P,C)WhenCT/EnginedetectsthattheamountofstoragecarvedorinuseisabovetheQUIESCEthresholdpercentage,itentersquiescemodeanddoesnotpermitnewdialogsorsessionstostart.
Forfreestorage,quiescemodecontinuesuntiltheamountofstorageinusedropsbelowarecoverypoint,calculatedasfollows:Recoverypoint=Thresholdamount-((MAXIMUM-Thresholdamount)/2)Forexample,withaMAXIMUMof10megabytesandaQUIESCEvalueof90:Recoverypoint=9M-((10M-9M)/2)=8.
5MForcarvedstorage,quiescemodehasnorecoverypoint.
UntilCT/Engineisrecycled,nonewsessionsordialogscanbestarted.
However,existingsessionsanddialogscontinuetooperatenormally.
YoucanusetheSTGMONparametertocontrolreportingonquiescemodeconditions.
See"STGMON"onpage153.
RESERVERESERVE(512,P|n,P)RESERVE(2048,X|n,X)Thevariablenrepresentsthenumberofkilobytesofprimary(P)orextended(X)storagetosetasideforotherroutinesthatmayperformtheirownGETMAINsintheCT/Engineaddressspace(forexample,ACF2andRACF).
Thedefaultforprimarystorage(P)is512.
Thedefaultforextendedstorage(X)is2048.
Primarystorageisbelowthe16-megabyteline,andextendedstorageisabovetheline.
Tospecifyvaluesforbothprimaryandextendedstorage,includetheRESERVEparametertwiceinTLVSYSIN:RESERVE(n,X)RESERVE(n,P)IftheRESERVEvalueislargerthantheMINIMUMvalue,CT/Engineterminates.
ThetotaloftheMINIMUMandRESERVEvaluesmustbelessthanorequaltotheMAXIMUMvalue.
IfyouhaveACF2orRACFinstalled,thedefaultsetting(512,P)supportsabout500users.
ACF2andRACFuseapproximately1Kofprimarystorageperlogged-onuser.
IfyourRESERVEvalueistoosmall,youmayencounterIST566ImessagesfromVTAMorS80A,S878,S066,S40D,orS0F9abends.
QUIESCEChapter12.
CL/SuperSessionStartupParameters151SDUMPSDUMP(Y|N|S|M)DetermineswhetherornotSVCdumpsaregenerated.
IftheCT/EnginejobstepisAPF-authorized,thedefaultisY.
Otherwise,thedefaultisN,andyoumustAPF-authorizetheCT/EnginejobstepbeforeyoucanspecifySDUMP(Y).
YSpecifiesthatanSVCdumpistobedirectedtoasystemdumpdataset(SYS1.
DUMPxx).
TocaptureanentireSVCdump,performthesesteps:1.
EnsurethattheSYS1.
DUMPxxdatasetsarelargeenoughtoholdthecontentsoftheCT/Engineaddressspace.
2.
DeterminethesizeoftheCT/Engineaddressspace.
3.
ProvideenoughDASDintheSYS1.
DUMPxxdatasetstoaccommodatetheSDUMPrequirements.
ForMVS/ESA3.
1.
3andhigher,SDUMPwritesanunblocked4160-byterecordforeachpageofvirtualstoragebeingdumped.
ForearlierversionsofMVS,therecordsizeis4104bytes.
RecommendedstorageguidelinesforSVCDUMPdatasets:vAllocate32megif16to32megarespecifiedinTLVSYSINforMINIMUM/MAXIMUMkeywords.
vForeachadditional16megspecifiedinTLVSYSINforMINIMUM/MAXIMUMkeywords,add25megfortheSVCDUMPdataset.
Forexample:MINIMUM(16384,x)-Allocatea32megSVCDUMPdatasetMINIMUM(32768,x)-Allocatea57megSVCDUMPdatasetMINIMUM(49152,x)-Allocatea82megSVCDUMPdatasetMINIMUM(65536,x)-Allocatea107megSVCDUMPdatasetNSpecifiesthataformatteddumpshouldbedirectedtotheTLVSNAPdataset.
Formatteddumpsshouldbeavoidedwhenpossible;theydisabletheCT/EngineaddressspaceforalongerperiodoftimethaneitherSVCdumpsorSYSMDUMPs,andaremoredifficulttoanalyze.
SSpecifiesthatasummarydumponlyshouldbedirectedtotheTLVSNAPdataset.
Asummarydumpconsistsofanabendsummaryandadispatchersummaryonly.
Warning:Summarydumpsdonotprovideenoughinformationtoallowproblemstobeanalyzed.
SDUMP(S)isprovidedonlyforveryspecifictestingpurposes,whereitisknownthatadumpwillnotbeneeded.
MSpecifiesthatthesystemshouldtakeanABENDdumptoadatasetdefinedwiththeSYSMDUMPddname.
ThistypeofdumpisnotformattedbytheoperatingsystemandmustbeanalyzedwithIPCS.
OnlythefirstdumptakenwillbecapturedontheSYSMDUMPdatasetunlesstheJCLspecifiesDISP=MOD,inwhichcasemultipledumpsmaybecollectedonthesamedataset.
CT/EngineautomaticallyinitializestheSYSMDUMPdatasetwithanend-of-filemarkatinitialization.
IfDISP=SHRorDISP=OLDisspecifiedfortheSYSMDUMPdataset,existingdumpswillbeoverwritten.
IfDISP=MODisspecified,thesystemwillwritethedumpfollowinganypreviousdumps.
SDUMP152IBMCL/SuperSessionforz/OSCustomizationGuideIfSDUMP(M)isspecifiedandtheSYSMDUMPDDNAMEismissing,ortheinitializationfails,startupisaborted.
Note:TheCT/EngineaddressspaceneednotbeAPF-authorizedtotakeaSYSMDUMP.
FormoreinformationregardingSYSMDUMPspecification,refertoIBM'sPlanning:ProblemDeterminationandRecovery.
STGMONSTGMON(15|n)Specifiesthenumberofminutesbetweenstoragequiescemodemessagedisplays.
Anyvaluebetween0and120isvalid.
Avalueof0resultsinmessagesbeingissuedonlywhenashort-on-storageconditionisdetectedorrelieved(forexample,whenthequiescemodestatechanges).
SWAPSWAP(N|Y)SpecifieswhethertheCT/EnginejobstepisAPF-authorizedandtheCT/Engineregionisswappable.
ThedefaultisNiftheCT/EnginejobstepisAPF-authorized.
Otherwise,itisY.
TASKSImportantDonotmodifythisparameterexceptundertheguidanceofanIBMsupportrepresentative.
TASKS(n)Defaultisthenumberofavailableprocessors.
Specifiesthenumberofgeneral-purposesubtaskstobeattachedintheCT/Engineaddressspace.
IfCT/Engineisrunningonamultiprocessor,theTASKSdefaultincreasesboththroughputandCPUusage.
ReducingthenumberoftasksdecreasesboththroughputandCPUusage.
Ingeneral,reducethevalueofTASKSonlywhenCPUusageisaconcernandsystempagingislow,sincefewertaskswillbeavailableforperformingworkwheneverothertasksareinapage-faultwait.
TRACEImportantDonotmodifythisparameterexceptundertheguidanceofanIBMsupportrepresentative.
TRACE(11|n)Specifies,astheexponentof2,thenumberofinternaltracetableentriestoreserve.
Eachentryconsistsof32bytes.
Forexample,TRACE(12)reserves4096traceentries.
IfTRACEisnotspecified,nointernaltracetablewillbeallocatedunlessDEBUG(Y)isspecified,inwhichcaseadefaulttracevalueof10isused,reserving1024tracetableentries.
TheinternaltracetableisincludedinadumpandprovidesusefuldiagnosticinformationforIBMSupport.
ElementsthatareincludedintheSDUMPChapter12.
CL/SuperSessionStartupParameters153internaltracetablearecontrolledbytheCT/EngineTRACEoperatorcommand.
ContactIBMSupportforinformationaboutthiscommand.
UPPERDLGUPPERDLG(N|Y)DetermineswhetherornotSSPLdialogoutputisfoldedtouppercasebeforedisplayingonusers'terminals.
ItisrecommendedthatyouspecifyYonlyifyourusers'terminalsdisplayKanjiorotherspecialcharactersinplaceoflowercasecharacters.
UPPERLOGUPPERLOG(N|Y)DetermineswhetherornotoutputfromtheLOGSSPLdialogfunctionisfoldedtouppercase.
(LOGoutputiswrittentoTLVLOG.
)ItisrecommendedthatyouspecifyYonlyifyourterminalsdisplayKanjiorotherspecialcharactersinplaceoflowercasecharacters.
UPPERWTOUPPERWTO(N|Y)DetermineswhetherornotoutputfromtheWTOSSPLdialogfunctionisfoldedtouppercase.
(WTOoutputiswrittentothez/OSconsoles.
)ItisrecommendedthatyouspecifyYonlyifyourz/OSconsolesdisplayKanjiorotherspecialcharactersinplaceoflowercasecharacters.
WTOWTO(Y|N)DetermineswhetherornotCT/EngineissuesWTOs.
WTOswriteinformationandexceptionconditionmessagestotheoperatorconsoles.
ALERTmessagesarealwayswrittentotheconsoles.
Note:WTO(N)willsuppressmessageswrittenwiththeWTOSSPLdialogfunction.
WTODCWTODC(ALERT,2|type,code,code,.
.
.
)SpecifiesWTOdescriptorcodesforCT/Enginemessagetypes.
SpecifyoneWTODCparameterforeachCT/Enginemessagetype.
Forexample,toassigndescriptorcode7(ApplicationProgram/Processor)toCT/Engineerrormessages,enterthefollowing:WTODC(ERROR,7)Fordefinitionsofthedescriptorcodes,seeIBM'sSupervisorServicesandMacroInstructionsmanual.
TRACE154IBMCL/SuperSessionforz/OSCustomizationGuideWTORCWTORC(ALERT,1,8,11|type,code,code,.
.
.
)SpecifiesWTOroutecodesforCL/SuperSessionmessagetypes.
SpecifytheWTORCparameterforeachCL/SuperSessionmessagetype.
Fordefinitionsoftheroutecodes,seeIBM'sSupervisorServicesandMacroInstructionsmanual.
WTORCChapter12.
CL/SuperSessionStartupParameters155156IBMCL/SuperSessionforz/OSCustomizationGuideChapter13.
ResponseTimeMonitorInterfaceTherearetwotypesofsessionscreatedwhenresponsetimemonitorsareused.
controlsessionAsessionbetweenthephysicalterminalLUandtheCL/SuperSessionentrypointACB.
YouareinsessionwithCL/SuperSessionwhenyouareunderdialogcontrol.
Forexample,whenyouare:vdoingadministrativeworkfromthemainmenuvinvokingadialogthroughatriggerrelaysessionAsessionthatiscreatedwhenyoujumpintoanapplicationsuchasTSOorCICS.
Arelaysessionismadeupoftworealsessions:onebetweenthephysicalterminalandCL/SuperSessionentrypointACBandonebetweenavirtualterminalandtheapplication.
Responsetimemonitoringproductsneedtoknowwhenyoucreateanewrelaysessionandwhenyouareinacontrolsession.
ThisisdonebymappingmessagesprovidedbyCL/SuperSessiontotheresponsetimemonitoreverytimeasessiontypeswitchoccurs,orwhenjumpingfromonerelaysessiontoanother.
Responsetimemonitoringproductsthenusethemappingmessagestocorrelatestatisticstothecorrectsession.
SupportETE(orNetSpy)canbeactivatedindependentlyorconcurrently.
Thischapterdescribestheinstallationprocedure.
TheCL/SuperSessionRTMcommandactivatestheinterfacetoETEandNetSpy.
FormoreinformationontheRTMoperatorcommand,seetheOperator'sGuide.
ETE(NetSpy)RecommendedInstallationProcedureTousetheRTMsupportforETE/NetSpy,youmustdothefollowing:vInstallVTAMVersion3.
1orhigher.
vInstallCL/SuperSessionatthesamehostwhereETE/NetSpyresides.
1.
Assembleandlinkedittheexit,&rhilev.
RLSSAMP(KLSXRTM),andputtheresultingloadmoduleintheCL/SuperSessionloadlibrary(&rhilev.
RLSLOAD).
TheUSEREXITisrequiredbytheNetSpyinterfacebutisoptionalforETE.
See"CustomizingUSEREXIT(KLSXRTM)"onpage159fordetails.
2.
UsetheadministratorfunctionstochangethesettingforRTMinterfacetoYinthecommonsegmentoftheglobalprofile.
IfyouwanttorestricttheETE/NetSpyinterfacetoaselectedgroupofusers,changethesettingforRTMinterfacetoYonlyinthecommonsegmentoftheselectedgroupprofile.
3.
Chooseoneofthefollowingoptions:a.
TostarttheinterfaceautomaticallywheneverCL/SuperSessionisinitialized,addoneofthefollowingcommandsto&rhilev.
RLSCMDS(KLSCINSS),andsaveit.
RTMONTYPE=ETEUSEREXIT=EXITRTM(ETE)RTMONUSEREXIT=EXITRTM(NetSpy)CopyrightIBMCorp.
1997,2015157b.
Tostarttheinterfacemanually,issueoneofthefollowingcommands.
RTMONTYPE=ETEUSEREXIT=EXITRTM(ETE)RTMONUSEREXIT=EXITRTM(NetSpy)4.
Usethe\otriggertoinvoketheKLSVTOPTdialog.
Apaneldisplaysvirtualsessionoptions.
VerifythattheRTMinterfaceisactiveforyoursessions.
Ifnecessary,changetheoptions.
5.
ForNetSpyonly,followthedirectionsspecifiedintheNetSpycontrollibraryasdefinedbymemberNSYSMGRI(NetSpySessionManagerInstall).
BesuretospecifyAPPLNAME=NETNAMEbeforeanyNetSpyAPPLstatements.
6.
ForNetSpyonly,defineCL/SuperSessiontoNetSpyintheNetSpyINITPRMmember:APPL=netnameSMANAGER=CLSSFORCEDR=100wherenetnameisthenetworknameoftheentrypointCL/SuperSessionACB.
MappingMessageFormatThemappingmessagehasthefollowingformat:PositionMeaning0-6Necessary3270controlcharacterstowritethemessagetotheterminalscreen.
7-13ThisfieldistheeyecatcherheaderthatidentifiesthedatastreamasamappingmessagetoETE/NetSpy.
ThedefaultisMONITOR.
NetSpyrequiresNETSPY@inthisfield.
ETEexpectsthedefaultbutalsorecognizesNETSPY@.
Tochangethedefault,youmustinvoketheUSEREXIT.
14-21Thenewapplicationnamewhenasessiontypeswitchoccurs,orwhenauserjumpsfromonerelaysessiontoanother.
Forcontrolsessions,thisfieldcontainsthesessionmanagernamerecognizedbyETE/NetSpy.
ThedefaultnameisCLSS.
YoucanoverridethedefaultwhenactivatingRTMthroughthesmanagerpositionalparameter.
ETEacceptsthedefault.
NetSpyrequiresthatthisnamebethesameastheSMANAGER=parameterontheNetSpyAPPLstatement.
Forrelaysessions,thisfieldcontainstheVTAMapplicationnamefortheapplicationthatisbroughttotheforeground.
22-29Forrelaysessionsthisfieldcontainsthevirtualterminal'snetworkaddress(subarea,elementaddress).
ThisfieldisblankwhenacontrolsessionmappingmessageispassedtoETE/NetSpy.
30-nAnyuserdata.
ThemappingmessageispassedbyCL/SuperSessiontotheUSEREXITbeforebeingtransmittedtothephysicalterminal.
See"CustomizingUSEREXIT(KLSXRTM)"onpage159fordetails.
ActivatingtheinterfaceTheRTMcommandactivatestheinterfacetoETEorNetSpyresponsetimemonitor.
ItallowsyoutospecifythesessionmanagernamerecognizedbyETEandNetSpyandtoactivateauserexit.
Thesyntaxofthecommandis:RTMON|OFF[smanager|CLSSUSEREXIT=exitnameONActivatestheinterface.
Iftheinterfaceisalreadyactive,itwillbedeactivated(asthoughanRTMOFFcommandwereissued)beforetheactivationrequestisprocessed.
ETE(NetSpy)RecommendedInstallationProcedure158IBMCL/SuperSessionforz/OSCustomizationGuideOFFDeactivatestheinterface,anddiscardstheexistingsessionmanagernameanduserexitname.
Youwillneedtorespecifythesewhenyoureactivatetheinterface.
smanagerIdentifiesthesessionmanagernametoETE/NetSpy.
exitnameIdentifiestheuserexitthatinspectsand/ormodifiesthemappingmessagejustbeforeitistransmittedtothephysicalterminal.
NetSpyrequiresthatyouspecifyUSEREXIT=EXITRTM.
MemberKLSXRTMin&rhilev.
RLSSAMPcontainsinstructionsforimplementingandextendingthesampleexit.
Also,see"CustomizingUSEREXIT(KLSXRTM)"fordetails.
CustomizingUSEREXIT(KLSXRTM)USEREXITisrequiredbyNetSpy.
ItisoptionalforETE.
ThisroutineisusedasamodelforwritinganRTMinterfaceexitthatcanbeusedtomofidythemappingmessage.
ThisroutinecanbeusedasistoprovidetheinterfacetoNetSpy.
Uponinvocationofthisroutinethefollowingoccurs:vR15containstheaddressofthemoduleentrypoint.
ThefirstwordoftheUSEREXITmustbeaNOPinstructionthatspecifiesthelengthofanyworkareathatwillbeallocatedbyCL/SuperSessionbeforetheexitisinvoked.
vR14containsthereturnaddressinthecallingmodule.
vR1containstheaddressofthemappingmessagethatwillbetransmittedtothephysicalterminal.
ThismessaggeismappedbythefollowingDSECT.
RTMMSGDSECTRTMmappingmessageRTMLLDCAL2(L'RTMTEXT)LengthofmappingmessageRTMSTARTDCXL7'F1401140401D6C'3270controlsRTMMONDCCL7'MONITOR'RTMnamerecognizedbyRTMRTMAPPLDCCL8'APPLNAME'RTMapplicationnameRTMSUBDCCL4'0001'Virtualterminal'ssubareaaddressRTMELEDCCL4'0001'Virtualterminal'selementaddressRTMNETAEQURTMSUB,*-RTMSUBVirtualterminal'snetworkaddressRTMTEXTEQURTMSTART,*-RTMSTARTDatastreamasprovidedbycallerRTMWORKDS256XUserarea.
vR0containstheaddressofthesavearea(andanyadditionalworkareathatwasrequested)forthisexitroutine.
vR2containstheaddressoftheUSERinformationblock.
ThiscontrolblockisREAD-onlyandismappedbythefollowingDSECT.
RTMUSERDSECTUserinformationblockRTUSERIDDSCL8USERIDRTGROUPDSCL8GROUPIDRTACCTDSCL40ACCOUNTINGinformationRTPTERMDSCL8PhysicalterminalLUnameThemappingdatastreamusesthe3270WRITEcommandtoeliminatetheperceivedflashingofthephysicalterminalscreenthatusersexperiencewithlongresponsetimes.
ThemappingmessageissenttotheterminalafteritisexaminedbyETE/NetSpyandmustresideinaseparatePIUfromanyregularoutputgeneratedbyCL/SuperSessionthatfollowsthemappingmessage.
BecauseofdevicelimitationsinhandlingtheERASEWRITEorERASEWRITEALTERNATEcommandwhichisincludedintheregularoutputthatfollowsthemappingmessage,CL/SuperSessionprovidesafeaturethatavoidstheERASEWRITEeffectwhenoutboundcompressionison.
ActivatingtheinterfaceChapter13.
ResponseTimeMonitorInterface159Note:Thisfeaturedoesnotapplytosessionswithoutboundcompressionturnedoffandisprovidedwiththefollowinglimitation.
Ifyoumodifythemappingmessage,youarelimitedtowritetothephysicalscreenbufferfromrow1,col1(position0),uptothelengthofthemessageasprovidedtoyouintheUSEREXIT(uptoposition285oftheterminalbuffer).
Ifyoudecidetoappendanyinformationtothemappingmessage(forexample,informationprovidedtoyouintheUserInformationBlock),youmustupdatethemappingmessagelength(RTMLL).
ThenumberofmappingmessagecharacterstransmittedbyCL/SuperSessiontotheterminalisspecifiedintheRTMLLfield.
Theresultsareunpredictableifyouattempttowritetothescreenbeyondpostion285.
ToturnoffthisfeatureyoumustcommentoutthefollowinginstructioninthesampleUSEREXIT.
OIRTMLL,X'80'TURNONVALIDATIONSWITCHForETE,theUSEREXITisinvokedonlytoavoidtheERASEWRITEeffect.
TocustomizeUSEREXITforETEyoucancommentoutthefollowinginstruction:MVCRTMMON,=CL7'NETSPY@'ChangemonitornametoNetSpyThecontentsoftheeyecatcherdatastreamthatistransmittedonthephysicalterminalsessionforexternalresponsetimemonitorsworksproperlyevenwith3270displaydevicesin16-bitaddressingmode.
Theeyecatcherdatastreamcontainsthree3270ordersequencesthatspecifybufferaddresszero(row1column1ofthedisplayscreen).
Thisaddressistransmittedeitherin12-bitaddressingmode(avalueofX'4040')orin14-bit/16-bitmode(avalueofX'0000').
Toaccommodate14-bit/16-bitaddressing,youmustuseNetSpyLevel4software.
Asatemporarymeasure,youmaymodifytheresponsetimemonitoruserexittoforcetheaddressfieldsto12-bitaddressinguntilNetSpyLevel4isinstalled.
MonitoringOtherApplicationswithNetSpyNetSpycanmonitoranyVTAMapplicationwhiletheuserisinsessionwithCL/SuperSession.
TomonitorVTAMapplicationsoutsideyourNetSpydomain,addAPPLstatementstotheNetSpyINITPRMmember.
NetSpywillnotrecognizethesessionmanagerinterfaceuntileitherauserlogsonorasessionswitchoccurs(thatis,untilavirtualsessionbecomestheactiveforegroundsession).
IfNetSpyisbroughtdownandbackup,thelogicalunits(LUs)beingdisplayedwillbevirtualterminalsuntiltheuserswitchessessions.
OncetheswitchoccursCL/SuperSessiontellsNetSpytherealLUnameandthatthisLUiscontrolledbyasessionmanager.
Youmayneedtousevirtualsessioninitializationdialogswithashortdelay,sothatNetSpycandetecttheswitchtoforeground.
NetSpydoesnotsupportparallelsessions.
Therefore,ifyouareimplementingtheNetSpyinterfaceforthefirsttime,youmayneedtoenlargeyourvirtualterminalActivatingtheinterface160IBMCL/SuperSessionforz/OSCustomizationGuidepoolsandchangeyourapplicationdefinitions.
Formoreinformation,seeChapter2,"VirtualTerminals,"onpage13andChapter3,"VirtualTerminalPools,"onpage19.
NetSpymustmonitorthephysicalterminalinordertocorrelateitsassociatedvirtualsessions.
UsetheDTcommandtodetermineifthephysicalsessionisbeingmonitored.
ParametersthatmaycauseNetSpynottomonitorthesessionare:vMAXLUvMAXLUontheAPPLstatementvTEXCLUDEvMAXAPPLvAPPLNAME=NETNAMEMonitoringOtherApplicationswithNetSpyChapter13.
ResponseTimeMonitorInterface161MonitoringOtherApplicationswithNetSpy162IBMCL/SuperSessionforz/OSCustomizationGuideChapter14.
StorageThissectiontellsyouhowtomonitorandreducestorage.
Theinformationinthissectionincludesbasicguidelinesandgeneralestimates.
However,everyconfigurationisunique,andsomeofourestimatesandsuggestionsmaynotapplytoyourspecificenvironment.
SeveralstartupparameterscontroltheallocationofstoragefortheCT/Engineaddressspace:vMAXIMUMvMINIMUMvRESERVEvQUIESCEForadetaileddiscussionoftheseparameters,see"CL/SuperSessionStartupParameters"onpage142.
StorageAllocationTheCT/EnginecomponentofCL/SuperSessionisresponsibleforstoragemanagement.
Storageisacquiredfromz/OSatinitialization,andthenmanagedbythestoragemanager.
ThisapproachsavesmoreCPUcyclesthancontinualz/OSGETMAINandFREEMAIN.
Atinitalization,CT/Engineperformsthefollowingforbothprimaryandextendedstorage.
1.
IfMINIMUM+RESERVEisgreaterthanMAXIMUM,MAXIMUMissettothattotal.
2.
CT/EngineissuesaconditionalGETMAINfortheMAXIMUMvalue.
3.
IftheconditionalGETMAINsucceeds,CT/EnginefreesthestoragerequestedandissuesanunconditionalGETMAINforthevalueofMAXIMUM-RESERVE.
MonitoringStorageTomonitorstorage,insertthefollowingcommandinmemberKLSSTARTof&rhilev.
RLSCMDS:EVERY30:00STORAGEThislogsastoragesummaryevery30minutes.
ExtendedStorageUseextendedstorageifyoucan.
SeeChapter12,"CL/SuperSessionStartupParameters,"onpage141fordescriptionsoftheMAXIMUMandMINIMUMstartupparameters.
Ifitisavailableandspecified,CL/SuperSessionusesextendedratherthanprimarystorageformoststoragerequests.
CopyrightIBMCorp.
1997,2015163StoragePreallocationMemberKLVINSTGof&rhilev.
RLSPARMenablesyoutotunecertainaspectsofCL/SuperSessionstoragemanagementandreducetheproduct'soverallrequirementforrealstorage.
KLVINSTGalsoallowspreallocationofstoragesubpoolsinordertoreduceworkingsetsize.
Trueworkingsetsizeisthenumberofpagesthatmustbeinprimarystorage(centralandextended)ifCL/SuperSessionistoexecuteefficientlyforagivenworkload.
Itistheamountofrealstoragetheproductrequiresinordertodelivergoodresponsetimetoaparticularnumberofactiveusers.
Sincetrueworkingsetsizeishardtomeasure,z/OSreportsworkingsetasthenumberofpagesthatresideinprimarystorageatagivenmoment.
Thisnumbermaybelargerorsmallerthanthetrueworkingset,butitcanserveasaroughindicationoftrueworkingsetinastorage-constrainedenvironment.
StoragemanagedbyCT/Enginecanbecomefragmentedovertime,leadingtoalargerworkingsetthannecessary.
KLVINSTGprovidesawaytoreducethisfragmentationbyhavingCT/Enginepreallocateanareaofstorageforsmallcontrolblocksthatarefrequentlyobtainedandfreed.
KLVINSTGprovidesforpreallocationofstoragesubpoolswiththedefaultsettingsfoundintheKLVINSTGmemberoftheinitializationlibrary&rhilev.
RLSPARM.
TheACCESSEDfieldoftheoutputdisplaysthenumberoftimesablockisallocatedandreleasedfromaparticularstoragesubpool.
Youcanusethisfieldtodeterminetherelativeactivityofeachstoragesubpool.
Topreallocatestoragesubpools,usethefollowingprocedure.
1.
AnalyzetheSTORAGEDETAILcommandoutputduringpeakperiodsofsystemactivity.
LookattheUSEcountforthesmallblocks,suchasSIZE(1-16)andSIZE(17-32).
ThefollowingisanexampleofSTORAGEDETAILoutput:KLVSD003ALLOCATIONDETAIL:KLVSD004SIZE(1-16)USE(20)TOTAL(105)ACCESSED(1204)KLVSD004SIZE(17-32)USE(0)TOTAL(1)ACCESSED(27)KLVSD004SIZE(33-48)USE(5)TOTAL(6)ACCESSED(67)KLVSD004SIZE(49-64)USE(1)TOTAL(2)ACCESSED(243)KLVSD004SIZE(65-80)USE(1)TOTAL(8)ACCESSED(24696).
.
.
KLVSD004SIZE(16385-32768)USE(0)TOTAL(3)ACCESSED(101)TheSIZEfieldshowstherange(inbytes)ofdatablocksizesinthesubpool.
Forexample,SIZE(1-16)indicatesthatthisareacontainsallblocksthatarefrom1to16byteslong.
TheUSEfieldshowsthenumberofblocksinuse.
TheTOTALfieldshowsthetotalnumberofblocksthathavebeenallocated.
Theimportantblocksizestofocusonforpreallocationare16,32,64,80,256,and512byteblocksfromextendedstorage(storageabovethe16MBline).
TheKLVINSTGmembercontainstheSIZEparameterwithdefaultsettingsthatpreallocatestorageforblocksizes16and32.
TheformatoftheSIZEparameterisSIZE(nnnnnnn,mmmmmmm,c)nnnnnnnThenumberofbytestopreallocateperblock(forexample,16forSIZE1-16).
StoragePreallocation164IBMCL/SuperSessionforz/OSCustomizationGuidemmmmmmmThenumberofblockstopreallocate(theTOTALvalueforthatsubpoolblocksize).
cThetypeofstorage:primary(P)orextended(X).
Preallocatingthesmallerblocks(16-to512-byteblocks)iscriticaltoimprovingstorageutilization,becausetheseblockstendtoincreasestoragefragmentation.
So,thesmallertheblock,themorebenefitsyoumayseewithpreallocation.
2.
UsethedefaultSIZEparametersinmemberKLVINSTGforyourfirstrun.
ThedefaultsettingsoftheSIZEparameterareSIZE(16,100,P)>SIZE(16,500,X)>SIZE(32,500,X)Note:Whenextendedstorageisavailable,youshouldnotneedtotuneprimarystorage,sinceitsuseisminimal.
Ifextendedstorageisnotbeingused,followstandardSTORAGEDETAILanalysistoestablishparametervalues.
3.
Duringaperiodofpeakactivity,recordtheUSEcountforeachblocksize(thoselistedinitem1onpage215)returnedbytheextendedportionoftheSTORAGEDETAILcommand.
4.
IftheUSEcountforthesmallblocksisrelativelyhigh(acountover1000),usethisnumbertoadjustthecountofthedefaultSIZEparametersinmemberKLVINSTG.
YoucanenterSIZEparametersforeachblockthatneedspreallocation.
Forexample,thefollowingdisplayshowsoutputfromtheextendedSTORAGEDETAILcommand:KLVSD002EXTENDEDMAINSTORAGEDETAILKLVSD003ALLOCATIONDETAIL:KLVSD004SIZE(1-16)USE(20)TOTAL(1629)ACCESSED(1204)KLVSD004SIZE(17-32)USE(0)TOTAL(1304)ACCESSED(27)KLVSD004SIZE(33-48)USE(5)TOTAL(32)ACCESSED(67)KLVSD004SIZE(49-64)USE(1)TOTAL(1191)ACCESSED(243)KLVSD004SIZE(65-80)USE(1)TOTAL(1545)ACCESSED(24696).
.
.
KLVSD004SIZE(16385-32768)USE(0)TOTAL(3)ACCESSED(101)Withthesecalculations,specifythefollowingstorageconfigurationswiththeSIZEparameterinmemberKLVINSTG:SIZE(16,1625,X)Enteracountof1625forsubpool16;TOTALcountof1629roundeddowntoamultipleof5.
SIZE(32,1300,X)Enteracountof1300forsubpool32;TOTALcountof1304roundeddowntoamultipleof5.
SIZE(48,30,X)Enteracountof30forsubpool48;TOTALcountof32roundeddowntoamultipleof5.
SIZE(64,1190,X)Enteracountof1190forsubpool64;TOTALcountof1191roundeddowntomultipleof5.
SIZE(80,1545,X)Enteracountof1545forsubpool80;TOTALcountof1545roundeddowntoamultipleof5.
Thisexampledisplayscalculationsforextendedstorage(X),butyouwouldusethesameprocedureforprimarystorage(P).
StoragePreallocationChapter14.
Storage165Ifyourworkingsetsizehasbeenreduced,yourpreallocationhasbeensuccessful.
Ifnot,youmaywanttorunthesystemandtrythecalculationsagain.
Itisimportanttodefineyourpreallocationsizesbasedonaloadedsystem.
Ifyouusenumbersthatarederivedfromoff-hours,suchasweekends,theywillnotbeaccurateforpeak-hourusagewhenthecountsaremuchhigher.
Ifregionstoragedefaultsarechanged(madesmaller,forexample),thepreallocationdefaultshouldbechangedaccordingly.
Ifyourenvironmentchanges—suchasmoreusers,ormoresessionsperuser,orifyouchangetheMINIMUMorMAXIMUMstoragestartupparameterinmemberKLSSYSIN—yourpreallocationshouldalsobechanged.
Inallcases,werecommendthatyouperiodicallyre-evaluateyourstartupparameters.
StoragePreallocation166IBMCL/SuperSessionforz/OSCustomizationGuideChapter15.
TablesUnload/LoadFacilityThetablesunload/loadfacilityunloadstablesfromtheCT/EngineaddressspacetoPDSmembersandloadsPDSmemberstoCT/Enginetables.
ThefacilityallowstablestobemovedfromoneCT/Engineapplicationtoanother,forexample,fromatestsystemtoaproductionsystem.
Theunload/loadfacilityprovidesvAnSSPLdialog,KLVTBULD,toprocessunload/loadrequests.
vNewlineandpull-downcommandsintheCT/Engineoperatorfacilitytounloadandloadtables.
RefertotheOperator'sGuideforinformationontheoperatorfacility.
TablesUnload/LoadUtilityDialogKLVTBULD,anSSPLdialog,unloadstablesandloadsPDSmembers.
KLVTBULDmaybeinvokedfromanyotherdialog,includingnon-terminaldialogs(NTDs).
Itperformsonlytheactualloadandunloadprocessesanddoesnotvalidatetheappropriatenessofarequest.
Thecallingdialogmustdeterminewhetheratableormembershouldbeoverwritten.
KLVTBULDdoesnotrequireapresentationspace,andmayberunasanon-terminaldialog(NTD).
InvokingKLVTBULDKLVTBULDrequiresthatatableandPDSnamearepassedtoit;itreturnsinformationaboutthesuccessorfailureoftherequest.
Whenyouunloadatable,usethefollowingdialogformat:dialogKLVTBULD(pack(0'UNLOAD''&tabhand''&pds''userdlg''lrecl'))unpack('&SysRC'rcreasonmsg)Whenyouloadatable,usethefollowingdialogformat:dialogKLVTBULD(pack(0'LOAD''tabvar''&pds''newname''userdlg'))unpack('&SysRC'rcreasonmsg)InputParametersUNLOADUnloadthetabletothePDS.
LOADLoadthetablefromthePDS.
Thetablemustnotexistonthetablesdatabase,norbeopenedbyanyuser.
&tabhandThehandleofthetabletobeunloadedtothePDS.
tabvarThenameofavariabletobeupdatedwiththehandleofthetableloadedfromthePDS.
Ifthetablecannotbecreated,tabvarwillbesetto0.
tabvarmustbedeclaredSCOPE(SHARED).
CopyrightIBMCorp.
1997,2015167&pdsThehandleofthePDSmember.
ForUNLOADthePDSmustbeopenedforWRITE(PDSSETWRT);forLOADitmustbeopenedforGET(PDSFIND).
Note:ThePDSdatasetmusthaveanLRECLof256orhigher,andaRECFMofVorVB.
AnystandardBLKSIZEisacceptable.
Bydefault,KLVTBULDsegmentsthetabledatatofitarecordsizeof256sothatthedatacanbeeditedusingISPF.
YoucanuseaPDSwithalargerLRECLtoreduceDASDspaceoverhead;specifytheactualrecordsizeaslrecl.
newnameThedesiredtablename.
Ifnull,thetablenameistakenfromtheunloadeddatain&pds.
userdlgThenameofadialogtobecalledatseveralpointsduringtheloadorunloadprocess.
Referto"UserDialog"onpage171fordetails.
lreclThelogicalrecordlengthof&pds.
Defaultsto256.
Ifthisvalueisgreaterthantheactualrecordlength,theunloadwillfailwithaPDSWRITEerror.
KLVTBULDreturnsapackedstringinthe&sysrcvariable.
Itconsistsofthreevalues:rcTheKLVTBULDreturncode.
reasonTheKLVTBULDreasoncode.
msgTheKLVTBULDmessage.
See"ReturnCodes"forexplanationsofeachvalue.
ReturnCodes0Successful;thetablehasbeenloadedfrom,orunloadedto,&pds.
reasonisnull.
msgcontainsthisinformation:vThedatethetablewasunloaded,asyy/mm/dd.
vThetimethetablewasunloaded,ashh:mm:ss.
vUserID(&vssuser)requestingthatthetablebeunloaded.
vTerminalID(&systerm)wheretheunloadrequestran.
Eachofthesevaluesis8characterslong,separatedbyasingleblank.
Note:Theuseridand/orterminalIDmaybeblanks.
Thisoccurswhentheutilityisrunasanon-terminaldialog.
1Atableservicesrequestagainstthetablebeingloadedorunloadedfailed.
reasonisatextstringthatidentifiesthetableoperation,forexample,TBGET.
messagecontainsthereturncodefromthetableservicesrequest.
2APDSservicesrequestagainst&pdsfailed.
reasonisatextstringthatidentifiesthePDSoperation,forexample,WRITE.
messagecontainsthereturncodefromthePDSrequest.
3Datastructureerror(LOADonly).
&pdscontainsaninvalidrecord.
reasonistherelativerecordnumber(1-based).
messageistheinvalidrecord.
Themostlikelyerroristhatthememberdoesnotcontainanunloadedtable.
4Userdialogfailed.
reasonindicatesthetypeoffailure:1.
Dialogdoesnotexistorcouldnotberefreshed.
InvokingKLVTBULD168IBMCL/SuperSessionforz/OSCustomizationGuide2.
Dialogfailedduringexecution.
msgisnull.
5Theparameterlistisinerror.
reasonidentifiestheproblem:1.
ThefirstargumentisnotLOADorUNLOAD.
2.
&tabhandisnotnumeric.
3.
tabvarisnullorlongerthan8characters.
4.
newnameislongerthan44characters.
5.
lreclisnotnumeric,islessthan256,orismorethan32767.
msgisnull.
6ThedatainthePDSismissinginformation.
reasonidentifiestheproblem:1.
End-of-filewasunexpectedlyreached.
2.
Thefirstrecordisnotthecontrolrecord.
3.
Adatavaluerecordwasnotprecededbyavariablenamerecord.
msgisthePDSrecordnumber(1-based)oftherecord.
4.
ThenumberofrowsinthecontrolrecorddoesnotmatchthenumberofrowsinthePDS.
5.
ThenumberofkeyornamevariablesinthecontrolrecorddoesnotmatchthenumberofkeysornamesfoundinthePDS.
6.
Thedataforavariableislongerthan32767.
msgisthePDSrecordnumber(1-based)wherethedatawouldexceedthemaximum.
Note:TheactualmaximumvariablelengthdependsonCT/Engineinitializationvalues.
7.
Akeyornamevariableisinvalid:eithernullornotseparatedfromthefollowingonebyaspace.
msgistherecordfragmentbeingprocessed.
Exceptwhereindicated,msgisnull.
7Theuserdialogrequestedthattheloadorunloadbeterminated.
reasonisthevaluereturnedbyuserdlg.
msgisthetablerownumber(1-based).
UsageNotes1.
Whenyouunloadatable,sortinformationisnotretained.
2.
Ifyoursiteisusingasecuritypackage,suchasRACF,theCT/EngineaddressspacemusthaveREADaccesstothePDSforLOADandWRITEaccessforUNLOAD.
3.
WhenKLVTBULDcompletestheseconditionsapply:vThetableremainsopen.
ForaLOADrequest,ithasbeenopenedWRITEandSHARE.
IssueTBCLOSEorTBSAVEtosavethetabletothetablesdatabase.
vThePDSisclosed.
WhenanUNLOADrequestfails,thecontentsofthePDSmemberareunknown.
4.
IfKLVTBULDreturnsaTBCREATEfailure,thetabvarvariableissetto0.
5.
AtthebeginningofeachloadorunloadrequestoneortwomessagesarewrittentoTLVLOG,identifyingthetablename,userid,andterminal.
Thesemessagescreateanaudittrailandcannotbesuppressed.
SeemessagesKLVDL201andKLVDL202intheCl/SuperSessionMessagesmanualformoreinformation.
6.
AlthoughKLVTBULDwillensurethatthedatabeingloadeddoesnotexceed32767inlength,theactualmaximumdependsontheCT/Enginestartupparametersandisgenerallyaround30K.
InvokingKLVTBULDChapter15.
TablesUnload/LoadFacility169UNLOADExampleThefollowingdialogisanexampleofhowtocodetheUNLOADprocessinadialog.
setPDSName'TEST.
DATASET'/*setnames*/setMember'TSTTABLE'/*forerrormsg*/setPDSHand(pds('SETWRT'/*openPDSWRITE*/'&Member'/*member*/'*&PDSName'))/*dsname*/if&PDSHand0Terminatetheloadorunload.
KLVTBULDterminateswithrcsetto7(userdlgrequestedtermination),andreasonsettothisreturncode.
userdataForanUNLOADrequest,datatobewrittentothePDSasoneormoreuserdatarecords.
Ifthisrecordislongerthanlrecl,itwillbesegmentedasrequired;however,eachsegmentwillbereturnedindependentlyonasubsequentLOADrequest.
ThisvalueisignoredforLOAD.
LOADExampleChapter15.
TablesUnload/LoadFacility171SampleUserDialogThefollowingexampleassumesthatasharedvariable,&MyDesc,containsadescriptionofatablebeingprocessed.
Thisdescriptionissavedinauserrecordwhenthetableisunloadedandisrestoredtothesharedvariablewhenthetableisloaded.
)declareActionscope(local)*requesttypeRowNumscope(local)*relativerow#UserDatascope(local)*datafromrecordMyDescscope(shared)*tabledescription)initunpack('&SysParm'Action/*getaction*/RowNum/*rownumber*/UserData))/*anduserdata*/if&RowNum=(neg3)setMyDesc'&UserData'elseif&RowNum=(neg1)and&Action='UNLOAD'setUserData'&MyDesc'return(pack(00/*keepgoing*/'&UserData'))/*returndata*/UnloadedDataStructureEachrecordinthePDSisvariablelength,uptothemaximumlengthspecifiedontheUNLOADrequest(lrecl).
Thefirstbyteindicatesthetypeofrecord.
Theremainderdependsonthetype:TypeContents0Tablecontrol.
Columnsandtheircontentsareasfollows:2Datalevel.
Thisisusedtodeterminethestructureoftheunloadeddata.
Theonlyvalidvalueis0.
3–46Tablename,left-justified,blankfilled.
47–56Numberofrows,right-justified,zerofilled.
57–66Numberofkeyvariables,right-justified,zerofilled.
67–76Numberofnamevariables,right-justified,zerofilled.
77–84Datethetablewasunloaded,asyy/mm/dd.
85–92Timethetablewasunloaded,ashh:mm:ss.
93–100Useridassociatedwithunloadrequest,left-justified,blankfilled.
Thesessionvariable&vssuserisusedtoobtainthisvalue.
101–108TerminalIDassociatedwithunloadrequest,left-justified,blankfilled.
Thesystemvariable&systermisusedtoobtainthisvalue.
1Keyvariables.
Eachvariablenameis8characterslong,left-justified,blankfilled.
Thenamesbeginincolumn2andareseparatedbyasingleblank.
Iftherearetoomanynametofitinarecord,anothertype1recordimmediatelyfollows.
Ifthetablehasnokeyvariables,therewillbenotype1records.
UserDialog172IBMCL/SuperSessionforz/OSCustomizationGuide2Namevariables.
Eachvariablenameis8characterslong,left-justified,blankfilled.
Thenamesbeginincolumn2andareseparatedbyasingleblank.
Iftherearetoomanynamestofitinarecord,anothertype2recordimmediatelyfollows.
Ifthetablehasnonamevariables,therewillbenotype2records.
3Reservedforfutureuse.
Ignoredifpresent.
4Variablename.
Columns2through9containthevariablename,left-justified,blankfilled.
Thevariablemaybekey,name,orextension;theexacttypemaybedeterminedbyscanningthedatainrecordtypes1and2foramatch.
Ifthenameisnotinthoserecords,itisanextensionvariable.
5Datavalue.
Columns2throughthemaximumrecordlength(lrecl)containthedata.
Ifthedataislessthanthemaximum,therecordisappropriatelyshorter.
Ifthedataislongerthanthemaximum,additionaltype5recordsfollowasneeded.
Theendofthevariabledataisindicatedbyarecordtypeotherthan5.
6End-of-row.
Thereisnootherdata.
7Reservedforfutureuse.
Ignoredifpresent.
8Userdata.
Thisrecordiscreatedbyrequestoftheuserdialog,userdlg.
Duringaloadrequestthisdataispassedtouserdlg,ifitwasspecified.
9End-of-table.
Thereisnootherdata.
Anyrecordsfollowingthisareignored.
AllotherrecordtypescauseKLVTBULDtoquitprocessingandreturnastructuralerrorcode,rc=3.
RecordsmustappearinthePDSinthisorder:1.
Thefirstrecordmustbetablecontrol,type0.
2.
Thenextrecord(s)mustbekeyand/ornamevariables,types1and2.
Thesemayoccurinanyorder,andmaybemixed.
Thenumberofkeyandnamevariablesdefinedbyrecordtypes1and2mustmatchthenumbersdeclaredinthecontrolrecord.
3.
Userrecordsmayappearatanypointafterthekey-andname-variablerecords.
4.
Eachvariableinarowconsistsofatype4record,whichdefinesitsname,andoneormoretype5records,whichcontainthevariable'sdata.
Type4and5recordsarenotrequiredwhenthevariableisakeyornameandthevalueiszerooranull.
However,aKLVTBULDUNLOADrequestwillalwaysgeneratetype4andtype5recordsforanullvariable.
Thetype5recordwillbeonebytelongandcontainonlytherecordtype.
Anullextensionvariablerequiresatype4recordforthenameandatype5recordthatconsistsonlyoftherecordtype.
5.
Attheendofeachrowisatype6record.
Thenumberofend-of-rowrecords(type6)mustmatchthenumberofrowsdeclaredinthecontrolrecord.
6.
Atype9recordappearsattheendofthetable.
UnloadedDataStructureChapter15.
TablesUnload/LoadFacility173UnloadedDataStructure174IBMCL/SuperSessionforz/OSCustomizationGuideChapter16.
PerformanceTipsThischaptersuggestswaystoimprovenetworkperformanceandstorageusewithCL/SuperSession.
Theinformationinthischapterincludesbasicguidelinesandgeneralestimates.
However,everyconfigurationisunique,andsomeofourestimatesandsuggestionsmaynotapplytoyourspecificsituation.
OverallPerformanceConsiderationsIngeneral,thefollowingconsiderationsdetermineoverallperformance:vModelofCPUinstalledvNumberandtypeofterminalsloggedonvNumberandtypeofsessionsbeingstartedvCumulativetransactionrateofallactivesessionsvUseofcompressionMultiple-ProcessorCPUsIftheKLVregionexecutesonamultiple-processorCPU,specifyingTASKS(1)in&rhilev.
RLSPARM(KLSSYSIN)causesCT/Enginetouseasinglesubtask,ratherthanonesubtaskperprocessor,formanagingtransactionthroughput.
ThisreducesoverallCPUusageattheexpenseofthroughput,sinceCT/Enginecannotexploittheotherprocessor(s)oraccomplishworkonthesameprocessorwhilewaitingforpaging.
ImportantUseTASKS(1)onlyifpagingislow.
Bydefault,CT/EngineusesthesamenumberofprocessorsasthenumberofTASKS.
CPUConsumptionCPUconsumptionismainlyrelatedtotransactionrates;itisnotaffectedbythenumberofusersorbythenumberofsessionseachuserhas.
CSAandECSAAllocationVTAMallocatesCSA(orECSA)onbehalfofCT/Engineasitdoesforanyotherapplication.
EachACBrequiresapproximately1600bytesofstorage,eachOPNDSTanother400.
HerearesometipstoeaseVTAMallocation.
vSpecifytheminimumnumberofvirtualterminalspossibletoVTAM.
Forrecommendations,seetheBasicConfigurationGuide.
vSpecifyEAS=1intheVTAMLSTAPPLstatements,sothatVTAMwillnotallocatea2Khashtable.
Thehashtableisnecessaryonlyforvirtualterminalsthatcanhavemorethan30simultaneoussessions(forexample,virtualterminalpoolswhoseVSMDEFINEcommandincludesthePARALLELparameter).
CopyrightIBMCorp.
1997,2015175Fornonparallelpools,mostvirtualterminalswillhavefewerthan30simultaneoussessions,andyoucanspecifyLIMIT=44intheVSMDEFINEcommands.
Formoreinformation,seev"EASParameter"onpage17.
v"VirtualTerminalSharing"onpage24.
vtheOperator'sGuide.
vIBM'sNetworkProgramProductsStorageEstimates.
vIBM'sVirtualStorageTuningCookbook.
APFAuthorizationAuthorizeCT/Engine(andanyassociatedTLVLOADlibrariesspecifiedintheCT/Enginestartupprocedure)sothatCT/EnginebecomesnonswappableandusesVTAM'sauthorizedpath.
SRBExitsCT/EnginesupportstheVTAMauthorizedpathandexecutionofVTAMexitsinSRBmode,toreducepathlengthandoverallCPUusage.
IfCT/Engineandtheassociatedlibrariesareauthorized,specifySRBEXIT=YESonallVTAMLSTAPPLstatementsassociatedwiththeKLVmajornode:vCT/EnginevallgatewaysvallvirtualdeviceACBsSRBEXIT=YESspecifiesthatsomeoftheVTAMexitroutinesruninsupervisorstate,keyzero(SRBmode),ratherthaninproblemstate(TCBmode).
DispatchingPriorityMakesurethatCT/EnginehasadispatchingpriorityimmediatelybelowVTAMandJES.
NoapplicationsshouldhaveadispatchingpriorityhigherthanCT/Engine.
ApplicationStatusMonitoringCL/SuperSessionletyouspecifytheintervalformonitoringapplicationstatus.
TheparameterthatcontrolstheintervalisMONITORin&rhilev.
RLSPARM(KLGINGWY).
See"SettingCL/SuperSessionInitializationParameters"onpage40.
Ifalargenumberofapplicationsaredefinedtoyoursystem,youcanlowerCPUusageandnetworktrafficbyincreasingtheMONITORinterval.
CompressionCL/SuperSessioncompressionconsistsofthefollowing:vOutboundDatastreamOptimizationCL/SuperSessionremovesrepeatedcharacters.
vScreenImagingCSAandECSAAllocation176IBMCL/SuperSessionforz/OSCustomizationGuideCL/SuperSessionmaintainsinmemoryanimageofthephysicalterminalandsendschangesonly.
Ifyouusecompressiononlywhennecessary,youwillsaveCPUcyclesandeliminateoneterminalbuffer,whichuses2Kto8Kofstorage.
(Ifavailable,extendedstorageisalwaysused.
)Thebenefitsofcompressionvarygreatlywiththeapplication.
ISPFalreadyusesoptimizeddatastreams;therefore,thebenefitofcompressionisminimal.
CertainPC-basedfiletransferapplicationsmayworkimproperlywithcompression.
Theseapplicationsexpectspecifichexpatternsinaspecificorderandcannotinterpretacompressed3270datastream.
Youcanpreventfiletransferproblemsbyaddingthe\fttrigger,whichcallsdialogKLSFXFERforthespecifiedsessionandvsetsoutbounddatacompressiontoNovsetsinbounddatacompressiontoNovsetsqueryPASSTHRUtoYesvsuspendstimeoutThe\fttriggeralsoinhibitsimmediatebroadcastandsetsvread-modifiedforPAkeystoNovread-modifiedforATTNkeystoNovfullreadmodetoNThe\fttriggerisatoggle;afterfiletransferiscomplete,theusercanreissue\fttoreactivatedatacompression.
Formoreinformationaboutaddingthe\fttrigger,refertotheUser'sGuide.
Printerdataisnevercompressed.
ThecommandVSHOWuseridSTATSshowstheresultsofcompressioninrealtime.
Atvirtualsessiontermination,compressionstatisticsarewrittentotheNetworkAccountingFacility(NAF)datasetintheCL/SuperSessionvirtualsessionterminationrecord.
See"CL/SuperSessionRecordTypes"onpage130.
DataCompressionforDialogPanelsDialogpaneldisplaysarebufferedmuchlikethewayvirtualsessionscreenimagesarebufferedbyCL/SuperSession.
ThismakesitpossibleforCL/SuperSessiontoprovideautomaticoutbounddatacompressionforpaneldisplays,regardlessofcompressionsettings.
AddingTriggersItisrecommendedthatyoucreatenomorethan40triggersperuser.
Thisistheupperlimitfortriggerdefinitionsbeforesomenoticeableamountofoverheadmaybecreated.
Thereasonfortheoverheadisthataninboundmessagewiththecursorlocatedinoneofthefieldsmustbescannedforapossibletrigger.
Althoughthescanningprocessisefficient,averylongtriggerlistcouldrequireanoticeableCompressionChapter16.
PerformanceTips177amountoftimetoscan.
178IBMCL/SuperSessionforz/OSCustomizationGuideAppendixA.
BringingUpaTestSystemWhenyoucustomizeyoursystem,youmaywanttotestyourmodificationsbybringingupatestcopyofCL/SuperSessiononthesamedomainasthecurrentproductioncopy.
Whenyoubringupatestsystem,manyoftheCL/SuperSessiondatasetscanbeshared.
However,certaindatasetsandmembersmusthaveuniquenamesandcannotbeshared.
Thechangerequirementsforatestsystemarelistedbelow.
Table10.
TestSystemRequirements.
NameRequiredChangeVSAMDatasetsNAM(rvhilev.
RLSNAM)UniquedatasetnameTABLEDB(rvhilev.
RLSTDB)UniquedatasetnameVIEWLOG(rvhilev.
RLSVLOG)UniquedatasetnameNote:VIEWLOGisoptional,butrecommended.
BSAMDatasetsNAF(rvhilev.
RLSNAF)UniquedatasetnameInitializationDatasetsandMembersrhilev.
RLSPARMUniquedatasetnameKLVINNAFDSNAME=mustreferenceuniquenameKLVINNAMDSNAME=mustreferenceuniquenameKLVINTBDSNAME=mustreferenceuniquenameKLVINVLGDSNAME=mustreferenceuniquenameKLVINVPOACBNAME=mustreferenceuniquenameKLSLV002Uniquename;changeinKLVINVPOKLSSYSINMustreferenceuniquenameKLSSTARTCommandDatasetsandMembersKLSSTARTUniquename;changeinrhilev.
RLSCMDSKLSLV000Uniquename;changeinKLSSTARTKLSLV001Uniquename;changeinKLSSTARTKLSGW001Uniquename;changeinKLGCHGGWKLSGW002Uniquename;changeinKLGCHGGWKLSGW003Uniquename;changeinKLGCHGGWKLS$VSMSUniquename;changein&rhilev.
RLSCMDSCopyrightIBMCorp.
1997,2015179Table10.
TestSystemRequirements(continued).
NameRequiredChangeSYS1.
VTAMLSTMustcontainuniquenamesforvirtualterminaldefinitionsBringingUpaTestSystem180IBMCL/SuperSessionforz/OSCustomizationGuideAppendixB.
CL/ENGINEProductLibrariesReferenceThisappendixcontainsinformationabouttheCT/Engineproductlibrariesthatareuser-modifiable.
TLVSYSINTLVSYSINcancontainoneormorekeywordsthatspecifyCT/Engine-wideprocessingvalues.
Itdoesnotcontainanyproduct-specificinformation.
RefertotheCustomizationGuideforalistofthevalidTLVSYSINkeywords.
SyntaxObservethesesyntaxruleswhencodingkeywords:vTLVSYSINcanbeeitherafixed-orvariable-lengthfile.
Note:AllCT/EngineSMP/E-distributedmaintenanceassumesafixed-lengthfilewith80-byterecords.
vEachphysicalrecordcancontainasequencenumber.
Sequencenumbersaredetectedaccordingtotheserules:Fixed-lengthfilesThelast8charactersofeachrecordareexamined.
Ifboththefirstandlastcharactersofthis8-charactersegmentarenumericvalues,therecordisassumedtocontainasequencenumberandthose8columnsareignored.
Otherwise,theyareconsideredsignificant.
Variable-lengthfilesThefirst8charactersofeachrecordareexamined.
Ifboththefirstandlastcharactersofthis8-charactersegmentarenumericvalues,therecordisassumedtocontainasequencenumberandthose8columnsareignored.
Otherwise,theyareconsideredsignificant.
vCompletekeywordsandanyvaluesspecifiedforthemononephysicalrecord.
Donotusecontinuations.
vYoucanspecifymorethanonekeywordonaphysicalrecord,separatedbyacommaorblanks.
However,itisnotrecommendedbecausecomplicationsformaintenanceanddebuggingresult.
vAnasteriskinthefirstdatapositionofaphysicalrecordcausestheentirerecordtobetreatedasacommentandignored.
vYoucanenterdatainmixedcase;itisalwaystranslatedtouppercaseinternallybeforeprocessing.
vIfyouspecifyakeywordmorethanonce,thelastvaluegenerallyisused.
Refertothedescriptionofeachkeywordforanydifferentprocessing.
vYoucanspecifykeywordvalueswithanequalssignorasetofparentheses.
Forexample,thefollowingkeywordsareequivalent:DEBUG=YDEBUG(Y)Itisrecommendedthatyouuseparenthesestodelimitthedatavisually.
CopyrightIBMCorp.
1997,2015181JCLOverridesThevaluesinTLVSYSINaremergedwithtwoothersetsofcontrolvaluesinthisorder:1.
Valuesdefinedinternally.
ThesevaluesareusedtosetthebasicCT/EnginedefaultsandarecontainedintheKLVST100module.
2.
AnyvaluesspecifiedintheTLVSYSINfile.
3.
AnyvaluesspecifiedwiththePARM=keywordoftheJCLEXECstatement.
Becausethelastspecifiedkeywordvalueistheonethatisused,youcanusePARM=tospecifykeywordoverrideswithoutchangingtheTLVSYSINdataset.
ThesyntaxrulesarethesameasforTLVSYSIN,withtheseexceptions:vSeparatekeywordswitheitheracommaorblanks.
vThePARM=stringcannotbelongerthan100characters.
Thisisaz/OSrestriction.
(RefertoIBM'sJCLReferenceformoreinformation.
)vz/OSalsorequiresthatthePARM=stringbeenclosedinsinglequotes.
vUseofcommentscausessyntaxerrors.
ExamplesFigure27showsanexampleofaTLVSYSINfile.
AnexampleofaJCLEXECstatementPARM=stringfollows.
//IEFPROCEXECPGM=KLV,PARM='TRACE(12),DEBUG(Y)'TLVPARMTLVPARMcontainsconfigurationinformationformostCT/EnginecomponentsandformanyCL/ENGINE-basedproducts.
Table17liststheCT/Engine-specificmembers.
Table11.
CL/ENGINETLVPARMMembers.
MemberComponentKLUINVSSVirtualSessionServicesKLVINDMDialogManagerKLVINNAFNetworkAccountingFacility***MEMBER:KLSSYSINCL/SuperSessionSTARTUPPARAMETERS****FUNCTION:****THISMEMBERCONTAINSTHERECOMMENDEDSTARTUPPARAMETERSFOR**THECL/SuperSessionADDRESSSPACE.
***LSRPOOL(32768,3)LSRPOOL(4096,32)LSRPOOL(2048,8)INITIAL(KLSSTART)OPSTART(KLSOPST)Figure27.
TypicalTLVSYSINFileTLVSYSIN182IBMCL/SuperSessionforz/OSCustomizationGuideTable11.
CL/ENGINETLVPARMMembers(continued).
MemberComponentKLVINNAMNetworkAccessManagerKLVINPSMPresentationSpaceManagerKLVINRLMResourceListManager(invokedaspartofNAMinitialization)KLVINSNSGlobalSenseCodeProcessorKLVINSTGStorageIsolationKLVINTBTablesManagerKLVINVLGViewlogKLVINVPOVTAMProgramOperatorKLVINVSMVirtualSessionManagerKLVINVTMVTAMSupportSyntaxObservethesesyntaxruleswhencodinginitializationmembers:vTLVPARMcanbeeitherafixed-orvariable-lengthfile.
AlllibrariesconcatenatedtotheDDmusthavethesameRECFMandLRECL.
Note:AllCT/EngineSMP/E-distributedmaintenanceassumesafixed-lengthfilewith80-byterecords.
vEachCT/Engineorproductcomponentlooksforonlyaspecifically-namedmember.
Thisisusuallythesameasthecomponent'sinitializationmodule.
(Thatis,theKLVINTBroutinereadstheKLVINTBmember.
)vEachinitializationmembercancontainsequencenumbers.
Sequencenumbersaredetectedaccordingtotheserules:Fixed-lengthfilesThelast8charactersofthefirstrecordareexamined.
Ifall8charactersarenumeric,theentirefileisassumedtocontainsequencenumbersandthose8columnsareignoredoneveryrecord.
Otherwise,theyareconsideredsignificant.
Variable-lengthfilesThefirst8charactersofthefirstrecordareexamined.
Ifall8charactersarenumeric,theentirefileisassumedtocontainsequencenumbersandthose8columnsareignoredoneveryrecord.
Otherwise,theyareconsideredsignificant.
vKeywordsandanyvaluesspecifiedforthemcanspanmultiplephysicalrecords.
Indicateacontinuationbycodingoneofthefollowingmarkersasthelastnonblankcharacterinarecord:minus(-)Thenextlineisconcatenatedtothecurrentlinewithoneblankseparatingthesignificanttext.
Forexample,KEYWORD1(VALUE1)-KEYWORD2(VALUE2)isprocessedasTLVPARMAppendixB.
CL/ENGINEProductLibrariesReference183KEYWORD1(VALUE1)KEYWORD2(VALUE2)plus(+)Thenextlineisconcatenatedtothecurrentlinewithallblanksretained.
Forexample,KEYWORD1(VALUE1)+KEYWORD2(VALUE2)isprocessedasKEYWORD1(VALUE1)KEYWORD2(VALUE2)Itisrecommendedthatyouusetheminus/hyphen(-)becauseitslightlyreducesparsingoverhead.
Usetheplussign(+)onlywhenaspecificnumberofblanksarerequiredas,forexample,inmessagetext.
vYoucanspecifymorethanonekeywordonaphysicalrecord,separatedbyacommaorblanks.
However,itisnotrecommendedbecausecomplicationsformaintenanceanddebuggingresult.
vAnasteriskthatisnotpartofaquotedstringcausestheremainderofthelogicalrecordtobetreatedasacommentandignored.
Forexample,KEYWORD1(VALUE1)*changedon10/12/92-KEYWORD2(VALUE2)isprocessedasKEYWORD1(VALUE1)*changedon10/12/92KEYWORD2(VALUE2)andtheKEYWORD2keywordisignored.
vYoucanenterdatainmixedcase;itisusuallytranslatedtouppercaseinternallybeforeprocessing.
Refertothedescriptionofeachinitializationmemberforanyexceptions.
vSpecifykeywordsonceonly,exceptwherenotedinthedescriptionoftheinitializationmember.
vSpecifykeywordvalueseitherwithanequalssignorasetofparentheses.
Forexample,thefollowingkeywordsareequivalent:TIMEOUT=10TIMEOUT(10)Itisrecommendedthatyouuseparenthesestodelimitthedatavisually.
ExamplesFigure28showsanexampleofaninitializationmemberinTLVPARM.
***MEMBER:KLVINTBTABLEACCESSMANAGERDATASET****FUNCTION:****THISMEMBERIDENTIFIESTHEVSAMDATASETUSEDBYTHETABLE**MANAGERTOSTORETABLES.
***&rvhilev.
RLSTDB-DISP(SHR)Figure28.
TypicalTLVPARMMemberTLVPARM184IBMCL/SuperSessionforz/OSCustomizationGuideTLVCMDSTLVCMDScontainscommandlists(CLISTs)thatmaycontainoneormoreCT/Engineorproductoperatorcommandsand/orinvocationsofotherCLISTs.
CT/EngineexecuteseachlogicalrecordinaCLISTasifithadbeenenteredatanoperator'sconsole.
Thus,asetofrelatedcommands,suchasthoseissuedduringCT/Engineinitialization,canbegroupedtogetherandinvokedbyjustonecommand.
RefertotheOperator'sGuideforinformationaboutCT/Engineoperatorcommands.
SyntaxObservethesesyntaxruleswhencodingCLISTs:vTLVCMDScanbeeitherafixed-orvariable-lengthfile.
AlllibrariesconcatenatedtotheDDmusthavethesameRECFMandLRECL.
Note:AllCT/EngineSMP/E-distributedmaintenanceassumesafixed-lengthfilewith80-byterecords.
vCLISTmembernamesare1to8characterslong.
ForcompatibilitywithpreviousCT/Enginereleases,theymaybeginwithadollarsign($).
DonotgiveaCLISTthesamenameasaCT/Engineorproductoperatorcommand.
Operatorcommandsarealwayssearchedforfirst.
vInvokeCLISTsbyenteringtheCLISTnamewithoutaprecedingdollarsign.
vEachCLISTmembercancontainsequencenumbers.
Sequencenumbersaredetectedaccordingtotheserules:Fixed-lengthfilesThelast8charactersofthefirstrecordareexamined.
Ifall8charactersarenumeric,theentirefileisassumedtocontainsequencenumbersandthose8columnsareignoredoneveryrecord.
Otherwise,theyareconsideredsignificant.
Variable-lengthfilesThefirst8charactersofthefirstrecordareexamined.
Ifall8charactersarenumeric,theentirefileisassumedtocontainsequencenumbersandthose8columnsareignoredoneveryrecord.
Otherwise,theyareconsideredsignificant.
vCommandsandtheirkeywordsmayspanmultiplephysicalrecords.
Indicateacontinuationbycodingoneofthesemarkersasthelastnonblankcharacterinarecord:minus(-)Thenextlineisconcatenatedtothecurrentlinewithoneblankseparatingthesignificanttext.
Forexample,CMDOP1-KEYWORD2(VALUE2)isprocessedasCMDOP1KEYWORD2(VALUE2)plus(+)Thenextlineisconcatenatedtothecurrentlinewithallblanksretained.
Forexample,TLVCMDSAppendixB.
CL/ENGINEProductLibrariesReference185MYCMDOP1+KEYWORD2(VALUE2)isprocessedasMYCMDOP1KEYWORD2(VALUE2)Itisrecommendedthatyouusetheminus/hyphen(-)becauseitslightlyreducesparsingoverhead.
Usetheplussign(+)onlywhenaspecificnumberofblanksarerequiredas,forexample,inmessagetext.
vSpecifyonlyonecommandorCLISTinvocationonalogicalrecord.
vAnasteriskthatisnotpartofaquotedstringcausestheremainderofthelogicalrecordtobetreatedasacommentandignored.
Forexample,CMDOP1KEYWORD2(VALUE2)isprocessedasCMDOP1andtheKEYWORD2keywordisignored.
vThePROFILEoperatorcommanddetermineshowcommandsthatyouenteraretreated.
IfPROFILEFOLDhasbeenspecified,alldataistranslatedtouppercase;otherwisethedataisleftasitwasentered.
Thismaycauseproblemsforsomecommandsthatdonotfoldtheiroperands.
Note:TheoperatorlogonCLIST,&thilev.
TLSCMDS(KLSOPST),issuesPROFILEFOLD.
vSpecifycommandkeywordsonceonly,exceptwherenotedinthedescriptionofthecommand.
vSpecifykeywordvalueseitherwithanequalssignorasetofparentheses.
Forexample,thefollowingkeywordsareequivalent:POOL=TSOPOOL(TSO)Itisrecommendedthatyouuseparenthesestodelimitthedatavisually.
ExamplesFigure29showsanexampleofaCLISTmemberinTLVCMDS.
*MEMBER:KLSSTARTCL/SuperSessionSTARTUP****FUNCTION:****THISCOMMANDLISTINITIALIZESCL/SuperSession.
***TRACE+DISPATCH*ACTIVATEDISPATCHERTRACEEVERY2:00*PREVENTS522ABENDSEVERY30:00STORAGED*LOGSTORAGEUSEEVERY30MINUTESEVERY30:00FLUSH*FLUSHVSAMLSRBUFFERSEVERY30MINUTESNODE&LSVT0*STARTCL/ENGINESTANDARDOPERATORFACILITYDIALOG&LSVT5KLVLOGON*STARTCL/ENGINECUAOPERATORFACILITYVSMDEFLU1&LSVT0TH(9)LOGMODE(SCS)DEFERFigure29.
TypicalTLVCMDSMemberTLVCMDS186IBMCL/SuperSessionforz/OSCustomizationGuideTLVPNLSTLVPNLScontainsSSPLdialogsusedbyCL/SuperSession.
RefertothefollowingdocumentsforinformationaboutcodingSSPLdialogs.
vSSPLProgrammingGuidevDialogLanguageReferenceManualTLVLOADTLVLOADcontainsCL/SuperSessionloadmodules.
Itmayalsocontainuserexitroutinesifyouhaveimplementedthem.
Table18liststheCT/Engine-specificmodulesthatyoucanimplement,andwheretheyaredocumented.
Table12.
CT/EngineTLVLOADLoadModules.
ModuleDescriptionReferenceKLSA2INHUsedwiththeLINKdialogfunctiontoimplementACF2logoninheritance.
CustomizationGuideKLSA2NEVNAMexitroutineforACF2(z/OSonly).
CustomizationGuideKLSNAFPTNAFprintroutine.
(ThismoduledoesnothavetobeinTLVLOAD.
)CustomizationGuideKLSNAF15NAFprintroutinesortexit.
(ThismoduledoesnothavetobeinTLVLOAD.
)CustomizationGuideKLSNAMPTNAMprintroutine.
(ThismoduledoesnothavetobeinTLVLOAD.
)CustomizationGuideKLSNAMPXNAMFIELDEXITroutine,tovalidatethesyntaxofsecuritydata.
CustomizationGuideKLSNAMXAbasicNAMvalidationexit.
CustomizationGuideKLSTSNEVNAMexitroutineforCA-TOPSECRET.
BasicConfigurationGuideKLSUSR20AnIPCS/AMDPRDMPverbexitforformattingCT/Enginetracerecords.
(ThismoduledoesnothavetobeinTLVLOAD.
)ProblemDeterminationGuideKLSXNPMNPMinterfaceexit,todeterminetheaccountcodetobepassedtoNPM.
CustomizationGuideKLSXRTMRTMinterfaceexit,todeterminethemappingmessagethatissenttothephysicalterminal.
CustomizationGuideusernameAusermodule,invocablewiththeLINKdialogfunction.
DialogLanguageReferenceManualTLVPNLSAppendixB.
CL/ENGINEProductLibrariesReference187SyntaxEachofthemoduleslistedintheabovetablemustbewritteninIBMassemblerlanguage.
Refertotheindicateddocumentforinformationaboutcoding,modifying,andimplementingtheexits.
TLVLOAD188IBMCL/SuperSessionforz/OSCustomizationGuideNoticesThisinformationwasdevelopedforproductsandservicesofferedintheU.
S.
A.
IBMmaynotoffertheproducts,services,orfeaturesdiscussedinthisdocumentinothercountries.
ConsultyourlocalIBMrepresentativeforinformationontheproductsandservicescurrentlyavailableinyourarea.
AnyreferencetoanIBMproduct,program,orserviceisnotintendedtostateorimplythatonlythatIBMproduct,program,orservicemaybeused.
Anyfunctionallyequivalentproduct,program,orservicethatdoesnotinfringeanyIBMintellectualpropertyrightmaybeusedinstead.
However,itistheuser'sresponsibilitytoevaluateandverifytheoperationofanynon-IBMproduct,program,orservice.
IBMmayhavepatentsorpendingpatentapplicationscoveringsubjectmatterdescribedinthisdocument.
Thefurnishingofthisdocumentdoesnotgiveyouanylicensetothesepatents.
Youcansendlicenseinquiries,inwriting,to:IBMDirectorofLicensingIBMCorporationNorthCastleDriveArmonk,NY10504-1785U.
S.
A.
Licenseesofthisprogramwhowishtohaveinformationaboutitforthepurposeofenabling:(i)theexchangeofinformationbetweenindependentlycreatedprogramsandotherprograms(includingthisone)and(ii)themutualuseoftheinformationwhichhasbeenexchanged,shouldcontact:IBMCorporationMailStationP300522SouthRoadPoughkeepsieNewYork12601-5400U.
S.
A.
Suchinformationmaybeavailable,subjecttoappropriatetermsandconditions,includinginsomecases,paymentofafee.
ThelicensedprogramdescribedinthisdocumentandalllicensedmaterialavailableforitareprovidedbyIBMundertermsoftheIBMCustomerAgreement,IBMInternationalProgramLicenseAgreementoranyequivalentagreementbetweenus.
Forlicenseinquiriesregardingdouble-byte(DBCS)information,contacttheIBMIntellectualPropertyDepartmentinyourcountryorsendinquiries,inwriting,to:IBMWorldTradeAsiaCorporationLicensing2-31Roppongi3-chome,Minato-kuTokyo106,JapanThefollowingparagraphdoesnotapplytotheUnitedKingdomoranyothercountrywheresuchprovisionsareinconsistentwithlocallaw:INTERNATIONALBUSINESSMACHINESCORPORATIONPROVIDESTHISPUBLICATION"ASIS"WITHOUTWARRANTYOFANYKIND,EITHEREXPRESSORIMPLIED,CopyrightIBMCorp.
1997,2015189INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFNON-INFRINGEMENT,MERCHANTABILITYORFITNESSFORAPARTICULARPURPOSE.
Somestatesdonotallowdisclaimerofexpressorimpliedwarrantiesincertaintransactions,therefore,thisstatementmaynotapplytoyou.
Thisinformationcouldincludetechnicalinaccuraciesortypographicalerrors.
Changesareperiodicallymadetotheinformationherein;thesechangeswillbeincorporatedinneweditionsofthepublication.
IBMmaymakeimprovementsand/orchangesintheproduct(s)and/ortheprogram(s)describedinthispublicationatanytimewithoutnotice.
Anyreferencesinthisinformationtonon-IBMWebsitesareprovidedforconvenienceonlyanddonotinanymannerserveasanendorsementofthoseWebsites.
ThematerialsatthoseWebsitesarenotpartofthematerialsforthisIBMproductanduseofthoseWebsitesisatyourownrisk.
Ifyouareviewingthisinformationsoftcopy,thephotographsandcolorillustrationsmaynotappear.
TrademarksIBM,theIBMlogo,andibm.
comaretrademarksofInternationalBusinessMachinesCorp.
,registeredinmanyjurisdictionsworldwide.
OtherproductandservicenamesmightbetrademarksofIBMorothercompanies.
AcurrentlistofIBMtrademarksisavailableontheWebat"Copyrightandtrademarkinformation",http://www.
ibm.
com/legal/copytrade.
shtml.
CA-ACF2andCA-TOPSECRETareregisteredtrademarksofComputerAssociatesInternational,Inc.
190IBMCL/SuperSessionforz/OSCustomizationGuideIndexSpecialcharacters$NAFR130DSECT130PREFIX130$NAMFEPLmacro121$NAMUEPLmacro117\fttrigger83,176&rhilev.
RLSCMDSlibrary90&rhilev.
RLSPARMKLVINDM96&rhilev.
RLSPARMlibrary90AABNLIGNR8ACB8CT/Engineoperatorfacility95CUAOperator3sharing24SPO3storagerequirement176virtualMTO3virtualterminal3VPO3accessmechanismorderNAM109network1accessibilityofIBMCL/SuperSessionforz/OSviiACCOUNTdataelement44ACF2EUA124extendeduserauthentication123LI124LID126logoninheritance124resourceclass112RLI126rulelistinterpret126userexit127withgroupprofiles126ACQ17MTOAPPL75acquisitionsequence41allocatingVIEWLOG101virtualterminal29ALTDESTAPPLDEF57AMODE31TLVSYSINparameter143APFTLVSYSINparameter143APFauthorization95NAF130performanceenhancement176APPL1,3,8,13AUTH16,75APPL(continued)ACQ17,75NVPACE17,75PASS17CT/Engineoperatorfacility95CUAOperator3definition3DLGMOD18EAS17entrypointCL/SuperSession3entrypointdialog1IMSoperator75MODETAB17MTO75NAM106PARSESS16performanceenhancement176RACFRACINIT112SAFRACINIT112SESSLIM18SRBEXIT18statements176storageconsiderations176virtualMTO3virtualterminal3VPO102VTAMProgramOperator102BUFLN102PASSWORD102SHARE102APPLDEF57ALTDEST57COMPRESS57delete57DESC57DEST57dynamicchange62GROUP57HELP57,63IMS57,76,78INITDLG57LOGON57MESSAGE57morethanoneperapplication62MULTSESS57NEWGROUP57NOLIST57ORDER57POOL57PRINTER57PRTPOOL57REMOVE57SIMLOGON57TERMDLG57USERDATA57applicationCLSDSTPASS2definitionCL/SuperSession72list66application(continued)dynamic66static66status40,176APPLIST66dataelement44dynamic66static66ASSIGN71,78,79dummyPTERM78IMSLTERMrequirements78IMSPTERMrequirements78AUTH16MTOAPPL75authorizationAPF95NAF130operator95authorizedapplicationlist66dynamic66static66authorizedpath7AutoinstallCICSwith27CICSwithout25automaticlogon93BBCGROUP67KLGINGWY40BIND23BLKSIZENAF129bracketprotocol,SNA33broadcastgroup67KLGINGWY40BSAMjournaldataset129bufferlength102size164BUFLN102BUFNO130Ccarvedstorage150CICSautomaticlogon93TCT25withAutoinstall27withoutAutoinstall25CL/ENGINEcommandsAPPLDEF57CL/SuperSessionapplicationdefinition72compatibility84virtualandphysicalterminals84compression84customization39,81CopyrightIBMCorp.
1997,2015191CL/SuperSession(continued)datacompression84defaulttriggerdialogs81defining40entrypoint40IDMSonlinemapping83implicitpartitionqueryreply83inbounddatacompression86initialization143AMODE31parameter143APFparameter143CONFIRMparameter143CONSECHOparameter143DATEFMTparameter144DEBUGparameter144INBDLIMparameter144INBOUNDparameter144INITIALparameter145INITLISTparameter145INTLCHARparameter146LIMITparameter146LOGBLOCKparameter146LOGBUFSparameter146LSRPOOLparameter146LSRSTRNOparameter147MAXIMUMparameter147MINIMUMparameter148OPLIMITparameter149OPLOCALparameter149OPMASKparameter149OPSTARTparameter149OUTBDLIMparameter149OUTBOUNDparameter150PACKparameter150QUIESCEparameter150RESERVEparameter151SDUMPparameter152STGMONparameter153SWAPparameter153TASKSparameter153TRACEparameter153UPPERDLGparameter154UPPERLOGparameter154UPPERWTOparameter154WTOparameter154WTODCparameter154WTORCparameter155initializationparameters40,176invalidcodepointtranslation86NAFrecordtype130,132GWLOGOFF132GWLOGON132GWPTSTOP132GWPTSTRT132VSSTLGF132VSSTLGN130VSSULGF130networkentrypoint40outbounddatacompression84physicalterminalcompatibilitywithvirtualterminal84queryreplyimplicitpartition83startup142CL/SuperSession(continued)triggerdialog81,82virtualterminalcompatibilitywithphysicalterminal84withvectorgraphics83CL/SuperSessionforIMScustomization71sessionservices71CL/SuperSessionsupportforIMSIMScommand77classexternal112ACF2112RACF112internal111protectedlist106,111resource111CLASSESNAM106cleanup,session74CLOSEACB31CLSDSTPASS2,3,17CNTRLPT110commandlibrary90compatibilityvirtualandphysicalterminals84COMPRESSAPPLDEF57compression84,176data84dialogpanel177filetransferproblems83,176statistics176configurationimplementation40member41MESSAGE54MESSAGE57CONFIRMTLVSYSINparameter143CONSECHOTLVSYSINparameter143continuationcharacters89,102controlpoint105dataset106ddname106DEFAULT106disposition106morethanone110conventions,documentationviiiCOUNT132CPUperformance175,176CSAallocation175CT/Enginecustomization95log106NAMfieldvalidation121operatorfacilityACB95APPL95automaticlogon93signonpanel96CT/EnginecommandsREFRESH94VPRINTER33VSMDEF20VSMDELETE31VSMDISPLAY32VSMLIST32CUAOperator3customizationCL/SuperSession39,40,81CL/SuperSessionsupportforIMS71CT/Engine95message106NAF129NAM105trigger81DDATANAM109datacompression84datadefinition41dataelementmodifier44OPTIONAL44REQUIRED44STATIC44dataelements41ACCOUNT44APPLIST44DEST44GROUP44LOGMODE44LTERM44NEWPSWD44PASSWORD44POOL44PROC44PRTLGMOD44PRTLTERM44PRTNODE44PRTPOOL44resolutionsequence47,53USERDATA44USERID47variablenames49dataflow,control33dataloss76datasource41,47databasecontrolNAMrecordtype112morethanone111table100DATEKLS@NAF132DATEFMTTLVSYSINparameter144DBNAM106DDNAMENAM106DEBUGTLVSYSINparameter144DEDICATEpoolincompatiblewithSESSLIM18192IBMCL/SuperSessionforz/OSCustomizationGuidedefaultcontrolpoint106datasource48,52pool20triggerdialogs81DEFAULT48,52EXIT48,51NAM47,49PANEL48,49qualifierDISPLAY49EXAMINE51LIMIT49PROMPT51USERDATA47,48DEFPOOL20deleteAPPLDEF57pool31virtualterminalpool31DEQUEUE71,77virtualMTOcommand77descriptionAPPLDEF57DESTAPPLDEF57dataelement44dialogcontinuationcharacters89controlpoint110customization87entrypoint1,3KLGATEWY1NEWSPAN69triggerdefault81windowcontrol82DIALOGcommand1,96DialogManagerPRELOAD96disconnectingalockedterminal92DISPNAM106display32PANELdatasource49virtualsessioninformation32virtualterminalpoolstatistics32DLGMOD18documentationconventionsviiiDSECT130DSNAMENAF129NAM106dummyPTERM78dumps152dynamicAPPLIST66virtualterminalcreation30EEABterminals164EAS3,17ECSAallocation175ENCDECfunction87entrypoint1,3CL/SuperSession40entrypoint(continued)dialog1DIALOGcommand96LU13entrypointdialog3entryvalidation130errorrecoverypop-up97ETE157EUA124implementation124installation124EVR130EXAMINE51EXITdatasource48,51EXAMINE51NAM106returncodes120,123user117,121exitroutinesNAM117,121returncodes120,123VTAM176explicitpartition24extendedattributebyte164extendeddatastream23extendedLTERMverification78extendedstorage150extendeduserauthentication123implementation124installation124externalclass112ACF2112RACF112resourceclass112ACF2112RACF112Ffencing,storage164FIELDEXITNAM110filetransferproblemswithcompression83,176trigger83,176firstcommandauthorization117operatorvalidation117FORCRESP76FORWARD2freestorage150Ggateway40configuration41change40implementation40message54GlobalSenseTableSupport97graphicssupport25,83GROUPAPPLDEF57dataelement44groupprofile126GWLOGOFF132GWLOGON132GWPTSTOP132GWPTSTRT132HHCFPOOL20HELPAPPLDEF57HGATES1HOSTGATE1,40HOSTGATEcommand40IIDMS83implicitpartition83IMSAPPL75APPLDEF57,77,78MTOvirtualsession3IMSdefinition77IMS/DCmodes76INBDLIMTLVSYSINparameter144INBOUNDTLVSYSINparameter144inbounddatacompression86inheritanceindicator124INITDLGAPPLDEF57INITIALTLVSYSINparameter145initialdialogAPPLDEF57initializationCL/SuperSession142AMODE31parameter143APFparameter143CONFIRMparameter143CONSECHOparameter143DATEFMTparameter144DEBUGparameter144INBDLIMparameter144INBOUNDparameter144INITIALparameter145INITLISTparameter145INTLCHARparameter146LIMITparameter146LOGBLOCKparameter146LOGBUFSparameter146LSRPOOLparameter146LSRSTRNOparameter147MAXIMUMparameter147MINIMUMparameter148OPLIMITparameter149OPLOCALparameter149OPMASKparameter149OPSTARTparameter149OUTBDLIMparameter149OUTBOUNDparameter150PACKparameter150QUIESCEparameter150RESERVEparameter151Index193initialization(continued)CL/SuperSession(continued)SDUMPparameter152STGMONparameter153SWAPparameter153TASKSparameter153TRACEparameter153UPPERDLGparameter154UPPERLOGparameter154UPPERWTOparameter154WTOparameter154WTODCparameter154WTORCparameter155NAF129BLKSIZE129BUFNO130DSNAME129MOD130SMF130NAM105parameters102tabledatabase100initializationlibrary90initializationparametersCL/SuperSession40,176KLVINPSM97VIEWLOG101VPO102initializationsequence(APPLDEF)57INITLISTTLVSYSINparameter145InteractiveSystemProductivityFacility(ISPF)90internalresourceclass111INTLCHARTLVSYSINparameter146invalidcodepointtranslation86isolation,storage164ISPFSeeInteractiveSystemProductivityFacility(ISPF)ISTINCLM22JJCLstartedtask8KKLGATEWY1KLGATEWYdialog1KLGDRES44KLGDRESdialog41,53KLGICFG140KLGICFG240KLGICFG340KLGINGWY40,176BCGROUP40MONITOR40,176KLGMSG1E57KLGMSG2P57KLS@NAF132KLSA2INH187KLSA2NEVuserexit187KLSINCLM23KLSSDCL94KLSSYSIN141,155performanceimprovement175TASKS175KLSTMTO75KLSUNKLPdialog92KLUINVSS182KLVA2NEV127KLVA2NEVuserexit117KLVINDM96,182KLVINNAF129BLKSIZE129BUFNO130DSNAME129MOD130SMF130,132KLVINNAM105,182KLVINPSM97,182KLVINRLM182KLVINSNS182KLVINSTG182KLVINTB100,182KLVINVLG101,182KLVINVPO102,182KLVINVSM182KLVINVTM103,182KLVNAMPXuserexit121KLVNAMXuserexit117KLVNAnnn106KLVTBULD167LLI124librarycommand90initialization90LID126LIMITPANELdatasource49TLVSYSINparameter146linemode89listvirtualterminalpoolstatistics32VSM32loadmodulesTLVLOADlibrary187lockedterminal,disconnecting92LOGNAM106LOGAPPL2,164LOGBLOCKTLVSYSINparameter146LOGBUFSTLVSYSINparameter146logmode22CICS22dataelement44dynamicselection23entry18,22extendeddatastream23IMS22table18,22logonAPPLDEF57automatic93logon(continued)inheritance124TSO25LSRPOOLTLVSYSINparameter146LSRSTRNOTLVSYSINparameter147LTERMassignment71,74,78withsessioncleanup80dataelement44LU13Mmajornode13mappingvirtualterminals29MAXIMUMTLVSYSINparameter147MEMORY8messageAPPLDEF57broadcastgroup68customizationNAM106quotationmark57SYSPANEL56tildecharacter57KLVNAnnn106NAM106quiesce153storage153SYSPANEL56MINIMUMTLVSYSINparameter148minornode13MOD130MODETAB17,22MONITORKLGINGWY40,176monitoringapplicationstatus40,176MSGNAM106MTOAPPL75ACQ75AUTH75NVPACE75virtual3,74multipleoperatorfacilities95multiple-processorCPU175MVSconsole94SAF106SystemAuthorizationFacility106NNAF129$NAFRDSECT130PREFIX130$NAFRmacro130APFauthorization130initialization129BLKSIZE129194IBMCL/SuperSessionforz/OSCustomizationGuideNAF(continued)initialization(continued)BUFNO130DSNAME129MOD130SMF130KLS@NAFCOUNT132DATE132TIME132TYPE132NAM106recordformat132layout132recordheader130recordtype130CL/SuperSession130EVR130GWLOGOFF132GWLOGON132GWPTSTOP132GWPTSTRT132SHUTDOWN130STARTUP130VSSTLGF132VSSTLGN130VSSULGF130VSSULGN130report132COUNT132DATE132TIME132TYPE132NAM105accessmechanismorder109APPL106RACFRACINIT112SAFRACINIT112CLASSES106combinedwithRACF110controlpointname106CT/Enginelog106DATA109datasource47,49databasemaintenance113morethanone111printing113usedforvalidation106DB106DDNAME106DISP106DSNAME106EXIT106,117,121returncodes120,121,123externalclass112ACF2112RACF112FIELDEXIT110initialization105LOG106maintenance112messagecustomization106NAF106NetworkAccountingFacility106NODB106NAM(continued)NOLOG106NONOTIFY106NORACF106NOSAF106NOTIFY106protectedclasslist106,111RACF106READAUTH112recordtype112databasecontrol112usercontrol112uservariable113variablecontrol113REQSTOR106,112REUSEPW106SAF106STAT106SUBSYS106,112userexit117,121returncodes120,123NAMdatabase105KLV@NAM113KLVASM113KLVNAMPT113maintenance112messagecustomization106printing113KLV@NAM113KLVASM113KLVNAMPT113NetSpy157foregroundsession160RTMcommand159virtualterminalpoolrequirements160network1networkaccess8NetworkAccessManager105NetworkAccountingFacilitySeealsoNAFinitialization130NAM106networkentrypoint1,3CL/SuperSession40DIALOGcommand96LU13NEWGROUP(APPLDEF)57NEWPSWDdataelement44news69NEWSPANdialog69NODBNAM106node13,95major13minor13NOLIST(APPLDEF)57NOLOGNAM106NONE(APPLDEF)57NONOTIFYNAM106nonresponsemode,IMS/DC76NORACFNAM106NOSAFNAM106NOTIFYNAM106numbermode89NVPACE17MTOAPPL75OOMEGAMONforMVSautomaticlogon93operatorAPPL75authorization95operatorconsole94operatorfacilityACB95APPL3,95multiple95timeout96OPLIMITTLVSYSINparameter149OPLOCALTLVSYSINparameter149OPMASKTLVSYSINparameter149OPNDST176OPSTARTTLVSYSINparameter149OPTIONALdataelementmodifier44OUTBDLIMTLVSYSINparameter149OUTBOUNDTLVSYSINparameter150outbounddatacompression84PPACKSYSINparameter150pagerate164PANELdatasource48,49DISPLAY49LIMIT49PROMPT51parallelsession16,24PARSESS16,24partitionexplicit24implicitqueryreply84PASS17PASSWORDdataelement44VTAMVPO102PCfiletransfer83problemswithcompression176performanceCPU175KLSSYSINparameter175tips175PFX8Index195physicalterminalcompatibilitywithvirtualterminal84pool19APPLDEF57dataelement44default20statistics32virtualterminal3,19default20portcontention35PREFIXNAF130PRELOADoption96presentationservices(PSERVIC)23primarystorage150printerAPPLDEF57NONE57OPTIONAL57REQUIRED57sharing33virtual33relievingportcontention35PROCdataelement44profilegroupwithACF2126withexternalsecuritysystem126ProgramOperator,VTAM3PROMPTdefault51PANELdatasource51protectedclasslist106,111TLVPARM111PRTLGMODdataelement44PRTLTERMdataelement44PRTNODEdataelement44PRTPOOLdataelement44APPLDEF57PSERVIClogmodetableentry23PTERM78Qqueryreplyimplicitpartition83QUIESCErecoverypoint150statechangemessages153threshold150TLVSYSINparameter150quotationmarkinmessages57RRACFcombinedwithNAM110NAM106PassTicket114RACINIT112resourceclass112RACROUTE106,112READAUTH112RECONNECTprocessinginTSO25recordheader,NAF130recordlayout,NAF132,139recordtypeNAF132CL/SuperSession130EVR130GWLOGOFF132GWLOGON132GWPTSTOP132GWPTSTRT132SHUTDOWN130STARTUP130VSSTLGF132VSSTLGN130VSSULGF130VSSULGN130NAM112databasecontrol112usercontrol112uservariable113variablecontrol113recoveryforinvalidinput97redefinepool31REFRESHoperatorcommand94removeAPPLDEF57pool31report,NAF132REQSTOR112NAM106REQUIREDdataelementmodifier44RESERVETLVSYSINparameter151RESETKLVINVLG101VIEWLOG101resolutionsequence53dataelement47resourceclass111external112conservation24definition3responsemode,IMS/DC76responsetimemonitor157returncodesexitroutines120,123REUSEPWNAM106RLI126RPFX8RTMcommand159rulelistinterpret126SSAFNAM106RACINIT112RACROUTE106,112STAT106SUBSYS106,112screensizeunspecifiedbind24SDUMPTLVSYSINparameter152SecondaryProgramOperator3security105encryptingpasswords87sensecodes97senseruledefinitionstatement97sessioncleanup71,74,77DEQUEUE77withLTERMassignment80foreground,withNetSpy160parallel16proceduretimeout103services71CL/SuperSessionsupportforIMS71CL/SuperSessionsupportforIMSrequirements76IMS/DCrequirements75switchingandgraphicssupport83variable94SESSLIM18SHARE102sharingACB24virtualprinter33virtualterminal24short-on-storage150,153showvirtualsessioninformation32virtualterminalpoolstatistics32signonpanel96CT/Engineoperatorfacility96SIMLOGON2APPLDEF57SINGLEsessiontype13SMF129KLVINNAF132NAF130SNAbracketprotocol33SOUT8SPO3SPT103SRBmode18,176SRBEXIT18,176startedtaskJCL8STARTUPCL/SuperSession142NAF130STAT106NAM106STATICapplicationlist66APPLIST66authorizedapplicationlist66dataelementmodifier44statisticsvirtualsession132virtualterminalpool32STEPLIB8STGMONTLVSYSINparameter153storage17,163carved150EABterminals164effectofbuffers164196IBMCL/SuperSessionforz/OSCustomizationGuidestorage(continued)extended150,163fencing164free150isolation164messages153monitoring163primary150SUBSYS106,112NAM106,112subsystemdefinition,IMS77supervisorstate18SVCdumps152SWAPTLVSYSINparameter153symbols,useofviiisyntaxTLVLOADlibrary187TLVPARMlibrary182SYSIN8PACK150SYSMDUMP152SYSPANEL56SystemManagementFacility(SMF)129Ttabledatabase100TablesUnload/LoadFacility167KLVTBULD167unloadeddatastructure172userdialog171TASKSTLVSYSINparameter153TASKSparameter175TCT(terminalcontroltable)CICS25TERMDLGAPPLDEF57terminal13connectionautomatic2methods1,3locked92virtual13terminationdialogAPPLDEF57thresholdquiesce150recovery150short-on-storage150tildecharacterinmessages57TIMEKLS@NAF132timeout103modifying92operatorapplication96sessionprocedure103TLVCMDSlibraryDDstatement8TLVH0ENUlibraryDDstatement8TLVLOADlibraryDDstatement8loadmodules187syntax187TLVLOGlibraryDDstatement8TLVPARMprotectedclasslist111TLVPARMlibraryDDstatement8syntax182TLVPNLSlibrary187DDstatement8TLVSNAPlibraryDDstatement8TLVSYSIN143AMODE31143APF143CONFIRM143CONSECHO143DATEFMT144DEBUG144INBDLIM144INBOUND144INITIAL145INITLIST145INTLCHAR146LIMIT146LOGBLOCK146LOGBUFS146LSRPOOL146LSRSTRNO147MAXIMUM147MINIMUM148OPLIMIT149OPLOCAL149OPMASK149OPSTART149OUTBDLIM149OUTBOUND150QUIESCE150RESERVE151SDUMP152STGMON153SWAP153TASKS153TRACE153UPPERDLG154UPPERLOG154UPPERWTO154WTO154WTODC154WTORC155TLVSYSINlibraryDDstatement8TRACETLVSYSINparameter153TRANRESP76transferfileproblemswithcompression83transferringfiles176triggercustomization81dialogdefault81windowcontrol82filetransfer83,176TSOautomaticlogon93logon25TSO(continued)RECONNECT25usinggraphics25TSOESA20TSOPOOL20TYPEKLS@NAF132Uunspecifiedscreensizebind23UPPERDLGTLVSYSINparameter154UPPERLOGTLVSYSINparameter154UPPERWTOTLVSYSINparameter154usercontrolNAMrecordtype112userexit127ACF2127KLVA2NEV117KLVNAMPX121KLVNAMX117NAM117,123returncodes120,121,123uservariableNAMrecordtype113USERDATAAPPLDEF57dataelement44datasource47,48keywordformat48relativepositionformat48USERIDdataelement47USStable2Vvariableassociatedwithdataelement49controlNAMrecordtype113customization94session94vectorgraphics83VIEWLOGallocation101initializationparameters101VIGMSG54VIRT327020VIRTDED20VIRTPARS20VIRTPASS20virtualMTO3,74APPL75ACQ75AUTH75NVPACE75VirtualMTOcommandsequence79virtualprinter33relievingportcontention35sharing33virtualsession3,13APPLDEF57Index197virtualsession(continued)displayinformation32statistics132withoutcompression84virtualstorageconstraintrelief71virtualterminal13CICS25compatibilitywithphysicalterminal84creationwithoutpools30dynamiccreation30mapping29optionsfiletransfertrigger83,176pool3,19default20liststatistics32sharing24virtualterminalpooldefault20VMautomaticlogon93VPO3initializationexample102initializationparameters102VPRINTER33,34VSMDEFINE20forCL/SuperSessionsupportforIMS76DELETE31DISPLAY32LIST32vsmpool19VSMS20VSS1VSSTLGFNAF132VSSTLGNNAF130VSSULGFNAF130VSSULGNNAF130VTAMAPPL1,3APPLdefinition3CLSDSTPASS2LOGAPPL2ProgramOperator3initialization102resourceconservation24definition3VTAM(continued)SecondaryProgramOperator3USStable2VPOBUFLN102PASSWORD102SHARE102VTAMauthorizedpath7VTAMexitroutines176VTAMLSTAPPLperformanceenhancement176storageconsiderations176VTPOPER95automaticlogon93Wwindowcontroltriggerdialogs82workingsetsize164WTOTLVSYSINparameter154WTODCTLVSYSINparameter154WTORCTLVSYSINparameter155198IBMCL/SuperSessionforz/OSCustomizationGuide