7/31/2019 Fundamentals of TSO
1/84
Instruction,ResearchandInfrastructureSupport,ArizonaStateUniversity
IBMMainframeJuly2002
FundamentalsofTSO
TableofContents
1.INTRODUCTION.................................................................................................11.1Abstract....................................................................................................11.2GeneralInformation................................................................................12.OVERVIEW...........................................................................................................12.1MajorComponents..................................................................................12.2TypicalTerminalSession........................................................................23.ACCESSINGTHESYSTEM.................................................................................33.1SystemSelection......................................................................................3
3.2TSOLogon................................................................................................43.3TSOLogoff...............................................................................................64.DATASETS...........................................................................................................74.1DataSetNamingConventions...............................................................74.2DataSetFormats......................................................................................104.3UnpressWYLBURDataSets..................................................................105.ISPF(MenuFacility)........................................................
.....................................115.1Overview....................................................................
..............................115.2TerminalKeys..........................................................................................135.3PFKeyList...............................................................................................135.4PFKeyValues..........................................................................................145.5HelpKey...................................................................................................145.6TechnicalNotes........................................................................................14
6.EDITOR..................................................................................................................157.BATCHJOBJCL....................................................................................................187.1JOBStatement..........................................................................................197.1.1PositionalParameters...............................................................197.1.2KeywordParameters................................................................20
7/31/2019 Fundamentals of TSO
2/84
7.2ROUTEStatement....................................................................................217.3JOBPARMStatement...............................................................................217.4TAPESStatement.....................................................................................227.5OUTPUTStatement.................................................................................227.6JCLLIBStatement....................................................................................228.BATCHJOBSUBMITTAL...................................................................................228.1SPF/PDFSUBMITCommand................................................................238.2TSOSUBMITCommand.........................................................................239.IOF(FetchingBatchJobOutput).........................................................................249.1InvokingIOF............................................................................................259.2On-lineHelpandTutorial......................................................................259.3RunningJobs(BatchJobs).......................................................................26
9.4InputJobs(BatchJobs)............................................................................269.5OutputJobs(PrintJobs)..........................................................................26MVS-i-TSO
7/31/2019 Fundamentals of TSO
3/84
FundamentalsofTSO
TableofContents
9.6HeldOutput.............................................................................................27
9.7SaveBatchOutputtoDisk......................................................................27
10.RACF(DiskandTapeSecurity).........................................................................28
10.1ProfileNames.........................................................................................28
10.2DiskFileSecurity...................................................................................29
10.3TapeVolumeSecurity...........................................................................29
10.4LISTUSER...............................................................................................29
10.4.1DisplayDiskQuota.................................................................30
10.4.2DisplayAccountNumber......................................................30
10.5ALTUSER...............................................................................................30
11.TSOCOMMANDS..............................................................................................31
11.1ALLOCATE...................................................................
.........................31
11.2CALL......................................................................................................32
11.3DELETE..................................................................................................33
7/31/2019 Fundamentals of TSO
4/84
11.4EXEC.......................................................................................................33
11.4.1ExplicitExecs...........................................................................33
11.4.2ImplicitExecs...........................................................................34
11.5EXECUTIL..............................................................................................35
11.6FREE.......................................................................................................35
11.7FTP..........................................................................................................35
11.8HELP.......................................................................................................36
11.9IOF..........................................................................................................36
11.10ISPF.......................................................................................................36
11.11ISRDDN................................................................................................36
11.12LINK.....................................................................................................37
11.13LISTALC...............................................................................................37
11.14LISTCAT...................................................................
............................37
11.15LISTDS..................................................................................................38
11.16LOADGO..............................................................................................38
7/31/2019 Fundamentals of TSO
5/84
7/31/2019 Fundamentals of TSO
6/84
Instruction,ResearchandInfrastructureSupport,ArizonaStateUniversity
IBMMainframeJuly2002
FundamentalsofTSO
1.INTRODUCTION1.1AbstractTSO(TimeSharingOption)providesaninteractiveenvironmentontheAcademicIBMMVSsystemforprogramexecution(interactiveandbatch),editing,printing,andmanagingdata.Muchofitsfunctionalityisprovidedbymenu-drivenfull-screenutilities.ThisdocumentdescribeshowtouseTSOanditsmajorcomponents.
1.2GeneralInformationInformationregardingIOF,JCL,printing,diskquotas,andtheurlforonlinehelphasbeenupdated.
2.OVERVIEWTSOisavailableontheAcademicIBMMVSsystem.Accessismadeviaatn3270telnet
session.("tn3270"isagenericreferencetoa3270-typeterminalemulator.Thestandardtelnetprogramusuallydoesnotemulatethisterminaltype.Aspecialtelnetprogramwhichemulatesaterminalinthe327xfamily(andwhichoftenhas"3270"initsname)isneeded.)
Note:Thesamemethods,software,useridsandpasswordsformerlyusedtoaccessfull-screenWYLBURareusedtoaccessTSO.
TSOisfairlysimpletouse.Asystemofmenusisprovidedfromwhichyouselect
thetaskstobeaccomplished.Thesetasksincludeusingtheeditor,submittingandmonitoringbatchjobs,interactiveprogramexecution,printing,andmanagingfiles.ThenamesofthemajorcomponentswhichprovidetheseservicesareISPF(themenusystem),SPF/PDF(theeditor),IOF(batchjobmonitor),andRACF(accountattributesandsecurity).
2.1MajorComponentsISPF(InteractiveSystemProductivityFacility)isamenu-drivenshellwhichsimplifiesTSOusageandprovidesnumerousutilityfunctions.Theutilityfunctionsinclude
creating,editing,deleting,printing,andrenamingfiles,andlookingatfiles,filedirectories,andcatalogentries.ISPFisalsousedasaninterfacetoaccessothersoftware
MVS-1-TSO
7/31/2019 Fundamentals of TSO
7/84
FundamentalsofTSO
onthesystemandoftenisrequiredforinteractiveexecution.ISPFistypicallyaccessedbyenteringthecommandISPF.
SPF/PDF(ProgramDevelopmentFacility)isafull-screeninteractivetexteditor.Itcanalsobeusedtosubmitbatchjobs.TheeditoristypicallyaccessedfromISPFutilities/dslistmenu,butcanalsobeaccessedfromtheISPFprimarymenu.
IOF(InteractiveOutputFacility)isafull-screeninteractiveutilityformonitoringbatchjobs,viewingbatchjoboutput,andpurgingorprintingbatchjoboutput.IOFistypicallyaccessedfromtheISPFprimarymenu.
RACF(ResourceAccessControlFacility)controlsdiskandtapefilesecurity,keepstrackofyourdiskspacequota,defaultprinterdestination,logonpassword,andseveralotheraccountrelatedattributes.RACFistypicallyaccessedfromtheISPFprimary
menu.
2.2TypicalTerminalSessionThetypicalsessionbeginswithatn3270telnetconnectionusingtheaddress"acmvs.inre.asu.edu".AssoonasthecommunicationslinkwiththeIBMsystemisestablished,aVTAMSystemSelectionscreendisplaysalistofsystemsandsub-systemsavailableforlogon.SelectAcademicTSOtostartthelogonprocess.
Thereafter,youarepromptedforauseridandthenforalogonpasswordandotheroptionalinformation.OneofoptionalitemsyoucandesignateisaTSOcommandtobe
automaticallyexecutedaspartofthelogonprocess.SomepeopleentertheISPFcommandtostartupISPFimmediatelyuponlogon;othersusetheEXECcommandtoexecuteaprogramorexec(typicallyinREXX)tocustomizetheirlogonprocess.
Ifyoulogonwithoutenteringanoptionalcommand,youareplacedinTSOnativemode,easilyidentifiablebyaREADYprompt.WhileinTSOmode,youcanenteranyTSOcommand.MostpeopleenterthecommandISPFtoactivatethemenu-drivenfull-screenfacilities.WhileitisnotnecessarytoactivateISPFbeforedoingusefulwork,somesoftwarerequireISPFtobeactiveforproperfunctioning.Inparticular,thefull-
screentexteditorPDFisnotavailableunlessISPFisactive.
AfterISPFisactive,theprimaryISPFmenuisdisplayed.YoucanselecttheEDIToptionontheprimarymenu(orintheUTILITIES/DSLIST)optiontoeditfilesandtosubmitbatchjobs.UsetheUTILITIESoptiontocreate,edit,delete,rename,andprintfiles.UsetheIOFoptiontomonitorbatchjobs.UsetheEXIToptiontoexitISPFand
7/31/2019 Fundamentals of TSO
8/84
returntonativeTSOmode.(YoumustexitISPFbeforetheLOGOFFcommandwillfunction.)
ToselectanISPFoption,typetheoption'scorrespondingidentifier(aletter,number,orword)ontheISPFcommandlineandpressENTER.Someoptionscauseothermenus
MVS-2-TSO
7/31/2019 Fundamentals of TSO
9/84
FundamentalsofTSO
toappearwhichoperateinthesamefashionastheprimarymenu.Someofthemenusmaycontainfieldsinwhichyouneedtotypevalues,suchasadatasetname,beforeproceeding.Asageneralrule,afteryou'veselectedtheappropriateoptionsandhavecompletedthedesiredtasks,youcanreturntotheprimaryISPFmenubypressingthePF3keyoneormoretimes.
ToexitISPFandreturntonativeTSOmode,selecttheXoptionontheprimaryISPFscreenorenterthecommand=XfromotherISPFscreens.Afteryou'vereturnedtonativeTSO,youcanenterotherTSOcommands,re-enterISPF,orlogoff.
3.ACCESSINGTHESYSTEM3.1SystemSelectionWelcometoASUComputingServices
*ThissystemisonlyforuseauthorizedbyASU*
STATUS
1.HELP2.ScheduledServiceInterruptions4.VM/CMS-InformationCenter(NodeASUACAD)ACTIVE8.AcademicTSO(NodeACADMVS)ACTIVE12.NextMenuRequest===>Enter1-12orPressPF1-PF12key
ThisisasampleSystemSelectionscreen.Theactualscreentowhichyouhaveaccessmaydiffersubstantiallyfromthatshownabove;however,theformatwillbesimilar.
ToselecttheAcademicTSOsystem:
??DeterminewhichitemonthescreencorrespondstoAcademicTSO(inthissample,8).??Typethecorrespondingnumber(8inthissample)intheinputfieldafterthe'===>'nearthebottomofthescreen,thenpressENTER.
AfterAcademicTSOhasbeensuccessfullyselected,thefollowingpromptwillappear:
IKJ56700AENTERUSERID
TypeyouruseridinresponsetothispromptandthenpressENTER.Thesystemwillsubsequentlypromptforalogonpassword(andotheroptionalinformation)ontheTSOLogonscreen.
MVS-3-TSO
7/31/2019 Fundamentals of TSO
10/84
7/31/2019 Fundamentals of TSO
11/84
FundamentalsofTSO
3.2TSOLogon-------------------------TSO/ELOGON---------------------------ENTERLOGONPARAMETERSBELOW:RACFLOGONPARAMETERS:USERID===>ABCDEPASSWORD===>NEWPASSWORD===>PROCEDURE===>ISPFPDFSGROUPIDENT===>ACCTNMBR===>12345SIZE===>4096PERFORM===>COMMAND===>
ENTERAN'S'BEFOREEACHOPTIONDESIREDBELOW:S-NOMAILS-NONOTICE-RECONNECT-OIDCARDPF1==>HelpPF3==>LogoffPA1==>AttentionPA2==>Reshow
YourequestspecificHELPbyenteringa'?'inanyentryfield.
ThisisasampleTSOLogonscreen.Theactualscreentowhichyouhaveaccessma
ydifferandmayhavedifferentvaluesforthevariousfields;however,theformatwillbesimilar.
ThesampleillustratespossiblelogonvaluesforuseridABCDE.Thevaluesdisplayedarethosewhichweresetwhentheaccountwasestablishedorwhichtheowneroftheuseridsetduringapreviouslogon.(HELPinformationforanyinputfieldmaybeobtainedbytyping?intheinputfieldandpressingENTER.YoumayalsorequesthelpbypressingthePF1key.)
Youmaytypeoneormorevaluesonthisscreen.UsetheTABkey(nottheENTERkey)tomovefromonefieldtoanother.UsetheENTERkeyafteryou'vefilledintherelevantfields.
Asageneralrule,youonlyneedtotypeyourlogonpasswordinthePASSWORDfieldandpressENTER.Thefirsttimeyoulogon,typeISPFintheCOMMANDfieldbeforepressingENTER.(Ifyouareusingaself-containedapplicationsuchasSAS,youmaywanttoenteracommandtostartSASinstead.)Ifit'salsothefirsttimeyou'veusedtheMVSs
ystem,typeanewlogonpasswordintheNEWPASSWORDfield.(Pleaserememberyournewpassword;youneedittologonnexttime.)
TheUSERIDfieldcontainstheuseridyouenteredinresponsetoalogonpromptonapreviousscreen.Iftheuseridisincorrect,pressthePF3keytorestartthelogonprocess.
MVS-4-TSO
7/31/2019 Fundamentals of TSO
12/84
7/31/2019 Fundamentals of TSO
13/84
FundamentalsofTSO
Ifthedisplayeduseridiscorrect,typethelogonpasswordinthePASSWORDfield.Thepasswordwillbeinvisible.
TheNEWPASSWORDfieldisusedtochangeyourlogonpassword.Donottypeanythinginthisfieldforanyotherpurpose.Thenewpasswordwillbeinvisible.Newpasswordshaveaminimumsizeof6characters,amaximumof8;containuppercasealphabeticcharacters(A...Z),digits(0...9),andnationalcharacters($#@);andcannotbeidenticaltooneoftherecentlyusedlogonpasswords.YouarerequiredtochangeyourpasswordthefirsttimeyouusetheMVSsystemandperiodicallythereafter.Thesystemwillpromptyoutoenteranewpasswordwhennecessary.
CAUTION:TYPEYOURNEWPASSWORDCAREFULLYandREMEMBERIT.Ifyouincorrectlytypethenewpasswordorforgetit,youwillnotbeabletodofuturelogons.Intheeventyouareunabletodeterminethepasswordfortheuserid,contacttheComputer
AccountsOffice.
ThestandardvalueforPROCEDUREontheAcademicTSOsystemisISPFPDFS.Thiscannotbechangedunlesstheuseridisauthorizedforotherprocedures.Theprocedureallocatesthestandardfilesnecessaryforinteractiveuseofthevarioussoftwarepackages.Youcancustomizethelogonprocedure,toallocateotherfilesortoperformotherfunctions,bytypinganEXECcommandintheCOMMANDfield(describedbelow).
ThestandardvalueforACCTNMBRistheuserid'saccountnumber.Thiscannotbechangedunlesstheuseridisauthorizedforotheraccountnumbers.
ThestandardvalueforSIZEis4096,whichrequests4MBofvirtualmemoryforyourTSOterminalsession.Eachmultipleof1024represents1MB.Ifthevalueissmallerorlargerthanyourneeds,typeanewvalue.Thisfieldcannotbechangedtoavaluegreaterthantheuserid'smaximumforaninteractivesession.Alluseridsaresetupwithamaximumof32MBforinteractiveprocessing.Batchjobscanbeusedtorun
programswhichhavelargermemoryrequirements.
TheCOMMANDfieldisusedtoexecuteasingleTSOcommandaspartofthelogonprocess.LeavethefieldblanktobeginyourterminalsessioninnativeTSOmode.Tobegininfull-screenISPFmode,typeISPFinthefieldTocustomizethelogonprocess,typeanEXECcommandintheCOMMANDfieldtoexecuteanexecyou'vewrittenineitherREXX(recommended)orCLIST;theexecmaycontainotherTSOcommandsandmayexecuteotherexecsandprograms.Toimmediatelyinvokeanapplication(for
7/31/2019 Fundamentals of TSO
14/84
exampleSAS)withoutgoingintonativeTSOorISPFmode,typethecommandwhichinvokestheapplication.
ThePERFORM,GROUPIDENT,andOIDCARDfieldsshouldbeblank.Thesefieldscannotbechangedunlesstheuseridisauthorizedforothervalues.
TheNOMAILandNONOTICEfieldsshouldbeStodisallowmessagereceptionduringlogonorshouldbeblanktoallowreceiptofmessagesduringlogon.Possible
MVS-5-TSO
7/31/2019 Fundamentals of TSO
15/84
FundamentalsofTSO
messagesthatmaybereceivedincludenotificationoffiletransferandnotificationofbatchjobcompletion.Itisrecommendedthatyouperiodicallyputblanksinthesetwofields.
TheRECONNECTfieldshouldbeblankunlessyouaretryingtoreconnecttoadisconnectedsession,inwhichcasetypeSinthefield.Adisconnectedsessionisautomaticallyloggedoffafterafewminutes,unlessyoureconnectbeforethelogoffoccurs.(ThereisnoTSOequivalentofaVM/CMSdisconnectedsessionwhichallowsaprogramtocontinueexecutionafterdisconnection.Ifyouhavealongrunningprogramoraprogramwhichrequiresmanyresources,youshouldexecuteitasabatchjob.)
Afterallrelevantfieldshavebeenupdated,pressENTER.Variousinformationalmessagesmayappearbeforethelogonprocesscompletes.Ifanylinesconsistingof
severalasterisksappear,pressENTERtocontinuetheprocess.
3.3TSOLogoffNativeTSOMode
IfyourterminalsessionisinnativeTSOmode(identifiablebytheREADYprompt),enterthefollowingcommandtologoff:
LOGOFF
ItisalsopossibletologoffoneuseridandsimultaneouslybegintheTSOlogonprocess
foranotheruserid.Thisisdonebyenteringthefollowingcommand,wherenewuseridrepresentstheuseridtobeusedforthelogonprocess:
LOGONnewuserid
ISPFMode
IfyouareusingISPF,returntonativeTSOmodebyexitingISPF.AfterexitingISPF,followthelogoffinstructionsshownaboveforNativeTSOMode.AbriefsummaryonhowtoexitISPFisgivenbelow:
??IftheprimaryISPFmenuisnotdisplayed,returntotheprimaryISPFmenu.ThisistypicallyaccomplishedbypressingthePF3keyrepeatedly.??OncetheprimaryISPFmenuisdisplayed,typeXonthecommandlineandpressENTER.
??Dependingoncircumstances,eithertheREADYpromptappears(nativeTSOmode)oranISPFscreenrequestingthedispositionoftheLOGand/orLISTdatasetsisdisplayed.
7/31/2019 Fundamentals of TSO
16/84
??IftheISPFLOG/LISTdispositionscreenisdisplayed,entertheappropriateinformationtoeitherprintordeletetheLOGorLISTfilesandthenpress
MVS-6-TSO
7/31/2019 Fundamentals of TSO
17/84
FundamentalsofTSO
ENTER.AbatchjobissubmittedtoprintthefilesandthenISPFexits.(MoreinformationonLOG/LISTisgivenlaterinthisdocument.)??Atthispoint,nativeTSOmodewillbeactive.RefertothelogoffinstructionsshownaboveforNativeTSOMode.
4.DATASETS4.1DataSetNamingConventionsSeveraldatasetnamingconventionsareusedontheMVSsystematASU,thetwomostcommonbeingTSOandWYLBUR.TheseconventionsaresubsetsofthestandardIBMMVSdatasetnamingconvention.Permanentdatasetswhichyoucreatemustcomplywithanappropriatenamingconvention.
BecausethenamingconventionforTSOisdifferentthantheoneusedforWYLBUR,peopleoftenask:CanIusemyWYLBURdatasetsfromTSO?
TheanswerisYES.FromTSOyoucanusedatasetsontheMVSsystemregardlessofthenamingconvention;however,certainTSOtasksaresimplerwhenthedataset
sbeingreferencedconformtotheTSOnamingconvention.SomeTSOfunctionsrequirepriordecompressionofdatasetsinWYLBUReditformat.
Severalnamingconventionsaredescribedbelow,beginningwiththestandardIBMdatasetnamingconvention.Fordatasetsyoucreate,theTSOnamingconventionisrecommended;however,youmayfindtheWYLBURnamingconventionmoreconvenientifyouhaveotherfileswhichconformtotheWYLBURconvention.
StandardIBMNamingConvention
-Adatasetnameconsistsofoneormorewordscalledqualifiers.
-Eachqualifierconsistsof1to8alphabetic,numeric,and/ornationalcharacters.(Thealphabeticcharactersaretheuppercaseletters(A...Z);thenumericcharactersarethedigits(0...9);thenationalcharactersarethedollar,pound,andcommercialatsigns($#@).
-Thefirstcharacterofeachqualifiermustbeeitheralphabeticornational.-Aperiod(.)isusedasaseparatorbetweenqualifiers.-Theoveralllengthofthedatasetname,includingperiods,cannotexceed44characters.-Amembernameenclosedinparenthesesmaybeappendedtothenameofapartitioneddataset
ifamemberofthedatasetisbeingreferenced.Themembernameconsistsofaonewordqualifier.Themembernameandtheenclosingparenthesesdonotcounttowardthe44characterlengthofthedatasetname.
MVS-7-TSO
7/31/2019 Fundamentals of TSO
18/84
7/31/2019 Fundamentals of TSO
19/84
FundamentalsofTSO
TSONamingConvention
-TheStandardIBMNamingConventionandtheconditionslistedbelowareused.
-Thedatasetnamemusthaveatleasttwoqualifiers.(Ifithasexactlythreequalifiers,italsoconformstotheISPFNamingConvention.)
-Thefirstqualifiermustbetheuseridofthedatasetowner.
-ForVSAMfilesonly,theCLUSTER,DATA,and(ifpresent)INDEXcomponentsmustexplicitlybegivennames.
ISPFNamingConvention
-TheTSONamingConventionisused,exceptthedatasetnamemusthaveexactlythreequalifiers.
WYLBURNamingConvention
-TheStandardIBMNamingConventionandtheconditionslistedbelowareused,exceptthe
nationalcharacters($#@)shouldnotbeusedinthedatasetnamenorinthemembername.
-Thedatasetnamesmusthaveatleastfourqualifiers.
-ThefirstqualifiermustbeWYLorVSM.WYLisusedfornon-VSAMfiles,andVSMisusedforVSAMfiles.(Thedistinctionbetweenthetwotypesoffilesfornamingpurposesisnolongerrequired.)
-Thesecondqualifiermustbethefirsttwocharactersoftheuseridwhichownsthedataset.
-Thethirdqualifiermustbethelastthreecharactersoftheuseridwhichownsthedataset.
-Afourthqualifierisrequired;additionalqualifiersbeyondthefourthareoptional.
-TheformerWYLBURenvironmentpermitteddatasetnamequalifierstohavemorethan8charactersandtohavenon-standardcharacters.Non-standarddatasetnamesmaycreatedifficultiesinotherenvironments.
-ForVSAMfilesonly,theCLUSTER,DATA,and(ifpresent)INDEXcomponentsmust
explicitlybegivennames.
-AmembernamefollowsthesamerulesaslistedforStandardIBMNamingConvention,exceptthatothercharactersarealsoallowed;however,theseothercharactersarenotrecommendedifthemembernameistobereferencedinanon-WYLBURenvironment.TheformerWYLBURenvironmentpermittedtwomethodsofdesignatingamembername:enclosingthemembernameinparenthesesorprecedingthemembernamewithapoundsign(#);thelatterisvalid
7/31/2019 Fundamentals of TSO
20/84
onlyinaWYLBURenvironment.
MVS-8-TSO
7/31/2019 Fundamentals of TSO
21/84
FundamentalsofTSO
Sampledatasetnamesareshownbelowforeachnamingconvention.TheuseridABCDEisusedforthoserequiringauserid.
DataSetNameNamingconvention
SYS1.PROCLIB(FORV2CLG)StandardIBMSYS2.WYL.PUB.LIBStandardIBMABCDE.CNTL(JCL)TSOABCDE.SURVEY.PIMA.Y90M03TSOABCDE.RURAL.COUNTYTSOandISPFABCDE.SAMPLE.DATA(PROJ2)TSOandISPFWYL.AB.CDE.LIB(LOGON)WYLBUR(non-VSAM)WYL.AB.CDE.PROJ5.FORTRANWYLBUR(non-VSAM)VSM.AB.CDE.HMWK5.INDEXWYLBUR(VSAM)
Inabatchenvironment(i.e.,inJCLstatements),datasetsarereferencedbyfullyqualifiednames;thatis,thefullnameofthedatasetisused.Ifasinglememberofapartitioneddatasetisbeingreferenced,thefullnameofthedatasetappendedwiththe
membernameenclosedinparenthesesmustbeused.
IntheTSOandWYLBURenvironments,undersomeconditions,anabbreviatedformofdatasetnamesispermitted.Itisalwayspermissibletousefullyqualifieddatasetnames.ThetablebelowillustratesvariouspossibilitiesforreferencingdatasetnamesfromtheTSO,WYLBUR,andbatchenvironments.
FullyqualifieddatasetnameReferencedfromReferencedasABCDE.BOTANY.PROJECTbatchJCLABCDE.BOTANY.PROJECTTSO'ABCDE.BOTANY.PROJECT'BOTANY.PROJECT
WYLBUR'ABCDE.BOTANY.PROJECT'"ABCDE.BOTANY.PROJECT"$ABCDE.BOTANY.PROJECTWYL.AB.CDE.SURVEY.DATAbatchJCLWYL.AB.CDE.SURVEY.DATATSO'WYL.AB.CDE.SURVEY.DATA'WYLBURWYL.AB.CDE.SURVEY.DATA'WYL.AB.CDE.SURVEY.DATA'"WYL.AB.CDE.SURVEY.DATA"$WYL.AB.CDE.SURVEY.DATASURVEY.DATA
Thoughnotshownabove,amembernamemaybespecifiedforpartitioneddatasets,
e.g.,'WYL.AB.CDE.DATA(PROJ3)'andSAMPLE.FORTRAN(MEAN).
Note:Adatasethasonlyonename.TherecannotbeaTSOnameforadatasetandaWYLBURnameforthesamedataset.InTSO,aWYLBURdatasetnamemustalways
MVS-9-TSO
7/31/2019 Fundamentals of TSO
22/84
FundamentalsofTSO
befullyspecifiedandenclosedinsinglequotes.ATSOdatasetnameisenclosedinquotesonlyifitisfullyspecified;otherwise,theTSOdatasetnameisnotquotedandtheleadingqualifier(theuserid)isomitted.
4.2DataSetFormatsTherecordformatofadataset(RECFM)istheprimaryindicatorofthedatasettype.Thelogicalrecordlength(LRECL)andblocksize(BLKSIZE)alsohelpindeterminingdatasettype.TSOcangenerallyworkwithdatasetshavingfixedformat(RECFMofF,FB,FBA,etc.)orvariableformat(RECFMofV,VB,VBA,etc.).PartitioneddatasetshavingaRECFMofUandaLRECLof0areusuallyloadmodules(binary,executableformofaprogram)andarecompatiblewithTSO.PartitionedorsequentialdatasetshavingaRECFMofU,aBLKSIZEof(usually)6233or7476,andanLRECLequaltothe
BLKSIZE(butsometimes0)maybeWYLBUReditformatfiles(compressedfilesreadableonlybyWYLBUR).
DatasetsinWYLBUReditformathavetobeconvertedtofixedorvariableformatbeforetheycanberead,written,edited,orsubmittedasbatchjobsfromTSO.TheinteractiveTSOutility%UNPRESSperformstheconversion.
4.3UnpressWYLBURDataSetsTechnically,thereisnosuchthingasa"WYLBURdataset";thistermnormallyreferstoadatasetwhichconformstotheWYLBURdatasetnamingconvention.
IfadatasetisnotinWYLBUReditformat,nospecialactionisneeded,thoughyoumaywanttorenamethedatasettoconformwiththeTSOnamingconvention.TSOandISPFhavecommandstorenamedatasetsandmembers.
TheTSOcommandforrenamingadatasetfromtheWYBURnamingconventiontotheTSOnamingconventionisshownbelow.(OntheISPFmenuforrenaming,whichisnotshown,yousimplytypethenewnameovertheexistingname.)
RENAME'WYL.AB.CDE.DATA1'DATA1
TheTSOcommandforrenamingamemberofapartitioneddatasetisshownbelow.(OntheISPFmenuforrenaming,whichisnotshown,yousimplytypethenewnamenexttoexistingname.)
RENAMEDATA1(OLD)DATA1(NEW)
IfadatasetisinWYLBUReditformat,theTSOutility%UNPRESSmaybeusedtoconvertthedataset.TheeasiestmethodistouseISPFoption3.4todisplayth
7/31/2019 Fundamentals of TSO
23/84
elistofWYLBURdatasetnames.Oncethelistisdisplayed,pressPF11oneormoretimesuntil
MVS-10-TSO
7/31/2019 Fundamentals of TSO
24/84
FundamentalsofTSO
thescreenwithatitlelineof"DsorgRecfmLreclBlksz"isdisplayed.UsePF7orPF8tomovethescreenupordowntoseeotherdatasetnames.ARecfmofUandaDsorgofPO(partitioned)orPS(sequential)indicatesapossibleWYLBUReditformatdataset.(Loadmodulelibrariescontainbinaryexecutableprograms,haveaRecfmofUandaDsorgofPObutarenotWYLBUReditformat.)(Note:Noharmisdoneifyoutrytoconvertaloadmodulelibraryorothernon-editformatdataset.)
Tabtothelinecontainingthenameofthedatasetyouwanttoconvert,andtype%UNPRESStotheleftofthenameandpressenter.Theconversionprocesstakesseveralsecondstocompleteforasmallfile,longerforlargerfiles.
Youcanalsouse%UNPRESSfromaTSOcommandline.AsampleTSOcommandforconvertinganeditformatdatasetisshownbelow:
%UNPRESS'WYL.AB.CDE.LIB'
Note:SomeearlierversionsofWYLBURwereunabletopreventyoufromsavinganon-editformatmemberintoaneditformatlibrary.Thenewmember(andonrareoccasionstheentirelibrary)wouldbecomeunusable.UNPRESSisunabletodecompresslibrarieswithsuchmembers;however,iftheoffendingmembersaredeleted,UNPRESSwillbesuccessful.
5.ISPF(MenuFacility)5.1OverviewISPF(InteractiveSystemProductivityFacility)isashellwhichprovidesaseriesofmenustosimplifytheuseofTSOandprovidesadditionalfunctionality.Onlyabrief
descriptionofISPFisgiveninthisdocument.
ToactivateISPF,typethefollowingcommandontheTSOcommandline:
ISPF
OnceISPFhasbeenstarted,amenu(alsocalledapanel)isdisplayed.AsampleprimarymenuforISPFisshownbelow:
MVS-11-TSO
7/31/2019 Fundamentals of TSO
25/84
FundamentalsofTSO
ISPF/PDFPRIMARYOPTIONMENU
OPTION===>
0ISPFPARMS-Specifyterminalanduserparameters
1BROWSE-Displaysourcedataoroutputlistings
2EDIT-Createorchangesourcedata
3UTILITIES-Performutilityfunctions
6COMMAND-EnterTSOcommandorCLIST
9IBMSOFTWARE-AdditionalIBMsoftware
DDATASETMGMT-Disk/TapeManagement,FileTransfer
IIOF-InteractiveOutputFacility
TTUTORIAL-DisplayinformationaboutISPF/PDF
XEXIT-TerminateISPFusinglogandlistdefaults
EnterENDcommandtoterminateISPF.
Thepanelsareusedtoidentifythetaskyouwishtoperform.Amenupanelhasalistofoptions,eachprecededbyanidentifier.Toselectanoptiononamenu,typethecorrespondingidentifier(forexample:3,9,orX)ontheOPTIONlineandpressENTER.SomepanelshaveaCOMMANDlineinsteadofanOPTIONline.(TheOPTIONorCOMMANDlinecanbeatthetoporthebottomofapanel.)Thistypically
resultsinanotherpanelbeingdisplayed.Thesubsequentpanelmaycontainanothermenu,oritmaycontainoneormorefieldsinwhichyouneedtoenterrequiredinformation.Forexample,ifoption2(EDIT)werechosen,thesubsequentscreenwouldcontaininputfieldswhereyouwouldtypethenameofthedatasettobeedited.
Note:TheidentifierassociatedwithaparticularitemonaspecificmenumaychangewheneverISPForitsassociatedmenusareupdated,especiallyifnewfeaturesoroptionsareadded.
Selectionofoptionsfromthemainmenucanalsobemadebytypingn.m,wherenisthemainmenuoptionandmisthesubmenuoption.Inthismanneryoucanmovedirectlytomenumwithouthavingtofirstselectnandthenm.Forexample,ifthemainmenuisnotcurrentlydisplayed,butyouwanttoselect3fromthemainmenuand4fromthesubmenu,type=3.4.Theequalsign(=)causesajumptothemainmenuwithoutdisplayingthemenubeforeprocessingtheindicatedoption.
7/31/2019 Fundamentals of TSO
26/84
YoucanusuallyreturntoapreviousmenubypressingthePF3keyortypingtheENDcommand.PressingthePF4keyortypingtheRETURNcommandwillgenerallyreturnyoutothemainmenu.
WhenISPFpanelsaredisplayed,youmaynoticedatafieldscontainvaluesenteredinpreviousISPFsessions.Insomeinstancesyoumaynotneedtochangetheentries.Tomakechanges,simplyovertypethefield.Anychangesyoumakemayberetainedanddisplayedthenexttimethesamepanelisdisplayed.
MVS-12-TSO
7/31/2019 Fundamentals of TSO
27/84
FundamentalsofTSO
5.2TerminalKeysA3270-typeterminalhasseveralprogrammablefunctionkeyscalledPFkeys.ToviewthevaluesofthePFkeysortochangetheirvalues,enterthecommandKEYSontheISPFcommandline.ThevaluesareusuallyshortISPForeditingcommands.Forexample,thePF3keyisusuallydefinedasEND;thePF4keyisusuallydefinedasRETURN.
Note:Programfunctionkeys(PF1,PF2,...,PF24),programattentionkeys(PA1,PA2),CLEARkey,INSERTkey,RESETkey,etc.,arenamesofkeysthatappearona3270typeterminal,whichyouareprobablynotusing.TheterminalemulatorsoftwarerunningonyourPCdeterminesthekeyboardmapping,i.e.,determineswhichkeyboardkeyscorrespondtothe3270-terminalkeys.Notallterminalemulatorsusethesamemapping.Ifyoudon'tknowthekeyboardmapping,checkthedocumentationwhichcamewithyourterminalemulatorsoftware.TheKEYScommanddoesnotaffect
thekeyboardmappingofyourterminalemulator,andthekeyboardmappingdoesnotaffectthevaluesassociatedwiththePFkeys.
On-linehelpisgenerallyavailablewithinISPF;presstheHELPkey(PF1)torequestHELPatanytime.Anon-linetutorialisavailablewhichexplainshowtouseISPFandwhatthevariousoptionsare;selectoptionTtobegintheISPFtutorial.
Panelsormenusareoftennested;thatis,onepanelmaycauseanotherpaneltoappear.ThePF3keyisusedtoexitapanelandreturntothepreviouspanel;usedrepea
tedly,itwilleventuallyreturntothemainmenu.IfthePF4keyisassignedthevalueRETURN,itcangenerallybeusedtoreturnimmediatelytothemainmenu.
ThePA1keymaybeusedtointerruptaprocess,suchasanexecutingprogram.ThePA2keyisusedtorefreshthescreenwithinISPF.TheCLEARkeyisusedtoclearthescreen;however,withinISPF,itisusuallynecessarytousethePA2keyimmediatelyafterusingtheCLEARkey.
5.3PFKeyListSomepanelsshowashortlistofavailablePFkeysatthebottomofthescreen;otherpanelsshownolistoronlyapartiallist.TocausethelistofavailablePFkeystoalwaysdisplayatthebottomofapanel,enterthefollowingcommandonanISPFcommandline:
PFSHOWON
7/31/2019 Fundamentals of TSO
28/84
Youcancontrolwhether12or24PFkeysareavailable.Ifyoudecidetohave24PFkeys,youcanalsocontrolwhethertohavethefirst12,thesecond12,orall24PFkeysappearinthemenuatthebottomofthescreen.UsethefollowingISPFcommandtocontrolthenumberandformatofPFkeysdisplayed:
MVS-13-TSO
7/31/2019 Fundamentals of TSO
29/84
FundamentalsofTSO
PFSHOWTAILOR
5.4PFKeyValuesThevalueofPFkeysmayvaryfromonepaneltothenext;i.e.,therearemultiplesetsofPFkeydefinitions,eachsethavingauniquename.OnegroupofpanelsmayuseaparticularsetofPKkeydefinitions,andanothergroupmayusethesameoradifferentsetofdefinitions.
YoucanchangethevalueofthePFkeys;however,itisrecommendedyoubecomefamiliarwiththeexistingvaluesandidentifywhichpanelsusethembeforemakinganychanges.
Severalmethodsexistformakingchanges.UseISPFoption0.3tochangethemainsetofPFkeydefinitions.UseISPFoption0.8tochangeothersetsofPFkeydefinitions,providedyouknowthenameofthesettobechanged.Ifyoudon'tknowthename,
gotothepanelforwhichthevaluesshouldbechangedandentertheISPFcommandshownbelow.
KEYS
5.5HelpKeyOnmostISPFpanels,thevalueofthePF1keyisHELP.YoucaneitherpressthePF1keyorenterthecommandHELPtogetcontextsensitivehelpinformation,whichisespeciallyusefulafterreceivinganerrormessage.
Ifyourequesthelp(bypressingPF1orenteringHELP)immediatelyafterreceivinganerrormessage,ISPFdisplaysadditionalinformationregardingtheerrorwhichhasjustoccurred.Requestinghelpagainmaydisplaymoreinformationonthesamesubjectoronabroaderscale.
5.6TechnicalNotesISPFrequiresapartitioneddatasetbeallocatedtotheddnameISPPROF;theallocationisdoneautomaticallyatlogontime.AtASU,thedatasetisnamed'userid.ISPFLIB',
where"userid"isreplacedwithyouruserid.Thisdataset(usuallytwotracks)shouldnotbedeleted;ISPFusesitforprocessingandtoretaincertainvaluesfromoneterminalsessiontothenext.ThedatasetiscreatedautomaticallywhenyoulogonTSOthefirsttime.Shouldyoueveraccidentallydeletethedataset,itwillbecreatedagainduringthenextlogon.
7/31/2019 Fundamentals of TSO
30/84
MVS-14-TSO
7/31/2019 Fundamentals of TSO
31/84
FundamentalsofTSO
ISPFrequiresaLOGfileandaLISTfile(bothareprintfiles)allocatedtotheddnamesISPLOGandISPLIST,respectively.Thisisdoneautomatically.YoucanuseISPFoption
0.2toexerciseadditionalcontrolofthesedatasets,suchassettingthedefaultProcessoptionfortheLOGfiletoD(delete)andfortheLISTfiletoPD(print,thendelete).YoucanalsousetheJCLtemplateatthebottomoftheLOG/LISTdispositionscreentoestablishafullyspecifiedJOBstatementanda/*ROUTEPRINTstatement.(DonotusethelinelabeledLocalprinterID.)TheJOBstatementandthe/*ROUTEPRINTstatementareusedtosubmitabatchjobwhichprintsthefileseachtimeyouexitISPF.(TheWYLBURformofaJOBstatementisnotvalidinTSO.)TheLOGfilecontainsalogofyourcurrentterminalsessions,andtheLISTfilecontainstheprintedresultsofcertainISPFcommands.(Printedoutputfrombatchjobsarenot
partofthesetwofiles.)Thesefilesusediskspacewhichcountstowardyourdiskquota.ISPFoption0.2includesfieldsfordeterminingthesizeofthesefiles
6.EDITORTheeditorprovidedwithISPF/PDFisISREDIT.Itiscommonlyreferredtobyavarietyofnames,includingSPF,PDF,SPF/PDF,ISPF/PDF,orISREDIT.Itisafull-screeneditorandmaybeusedtoeditamemberofapartitioneddataset(PDS)orasequentialdataset.("Library"isanothercommontermwhichreferstoaPDS.)Onlyabrief
descriptionoftheeditorisgiveninthisdocument.
Youcantypenewtextortypeoverexistingtextanywhereonthescreen.Certaineditingcommands,suchasI,C,MorD(Insert,Copy,MoveorDelete),canbeenteredinthelinenumberfields.Othereditingcommandsareenteredonthecommandline.UsethePF3keytoendeditingandautomaticallysavethechanges,oruseCANCELtoexitwithoutsavingthechanges.SAVEmayalsobeusedperiodicallytosavethechangeswithoutexitingtheeditor.
Ifthefilebeingeditedisintendedforbatchprocessing,theeditor'sSUBMITcommandmaybeusedtosubmitthedisplayedfiletothebatchqueue.IOFmaybeusedtomonitorthebatchjobortoretrieveitsoutput.
TheSPF/PDFeditorisinvokedfromtheISPFUtilities/Dslistmenu(option3.4)orfromtheprimaryISPFmenu(option2).
ISPFoption3.4istheeasiestmethodofinvokingtheeditor.Thisoptiondispla
7/31/2019 Fundamentals of TSO
32/84
ysalistofdatasetnames.Whenthelistisdisplayed,tabtolinecontainingthenameofthedatasettobeedited,typeanE,andpressenter.(Whenusingtheeditorviaoption3.4,anabbreviatedEditEntryPanelwillsometimesappear.Ifitdoes,justpressentertocontinue.)
ISPFoption2ismoreinvolvedandisdescribedinthefollowingparagraphs.(Whenusingtheeditorviaoption2,theentireEditEntryPanelwillalwaysappear.)
MVS-15-TSO
7/31/2019 Fundamentals of TSO
33/84
FundamentalsofTSO
Whenoption2isselected,theeditordisplaystheEditEntryPanelcontainingseveralinputfields,includingafieldforthenameofthedatasettobeedited.Afteryouhavetypedthedatasetnameandpressedenter,theeditorwilldisplaythefileifitcontainsdataorwilldisplayaninputscreenifthefileisempty.Asampleeditentrypanelisshownbelow:
EDITENTRYPANELCOMMAND===>
ISPFLIBRARY:
PROJECT===>
GROUP===>
TYPE===>
MEMBER===>(Blankorpatternformemberselectionlist)
OTHERPARTITIONEDORSEQUENTIALDATASET:
DATASETNAME===>
VOLUMESERIAL===>(Ifnotcataloged)
INITIALMACRO===>Enter"/"toselectoptionPROFILENAME===>/ConfirmCancel/Move/ReplaceFORMATNAME===>MixedMode
DATASETPASSWORD===>(Ifpasswordprotected)
Thedatasetnamemaybeenteredineitheroftwolocations:theDATASETNAMEfieldortheISPFLIBRARYfields(PROJECT,GROUP,andTYPE).IfboththeDATASETNAMEfieldandtheISPFLIBRARYfieldscontaindatasetnames,theDATASETNAMEfieldisused.OneusefulfeatureoftheISPFLIBRARYfieldsisthedatasetnameisretainedfromoneterminalsessiontothenext,butnotfortheDATASETNAMEfield.
TheDATASETNAMEfieldisbelow"OTHER...DATASET"inthemiddleofthescreen.Thisfieldmaybeusedforanysequentialorpartitioneddatasetname.Ifthe
datasetisaPDS,aparenthesizedmembernameshouldbeappendedtothedatasetname.Thedatasetnameandanymembernameshouldbeenclosedwithinsinglequotemarks.IfthefirstqualifierofthedatasetnamematchesyourPREFIX,thefirstqualifierandthequotemarksmaybeomitted.BydefaultyourPREFIXisequivalenttoyouruserid,unlessyouusetheTSOPROFILEcommandtochangethePREFIX.
Themembernameisrequiredforcreatinganewmemberandisoptionalforeditin
7/31/2019 Fundamentals of TSO
34/84
ganexistingmember.IfthemembernameisomittedforaPDS,amenuofexistingmembersisdisplayed;tabtothenameofthemembertobeedited,typeanSnexttothemembertobeeditedandpressenter.
EithertheISPFLIBRARYfieldsortheDATASETNAMEfieldmaybeusedifthefullyqualifieddatasetnamecontainsexactlythreequalifiers.RefertothepreviousparagraphforinstructionsonhowtousetheDATASETNAMEfield.FortheISPF
MVS-16-TSO
7/31/2019 Fundamentals of TSO
35/84
FundamentalsofTSO
LIBRARYfields,enterthefirstqualifierofthedatasetname(typicallyyouruserid)inthePROJECTfield;enterthesecondqualifierinthefirstGROUPfield;enterthelastqualifierontheTYPEfield.IfthedatasetisaPDS,enteramembernameintheMEMBERfield;themembernameisoptionalforeditinganexistingmember.IfthemembernameisomittedforaPDS,amenuofexistingmembersisdisplayed;tabtothenameofthemembertobeedited,typeanSnexttothemembertobeeditedandpressenter.
Thenextexampleillustratesselectingamemberfromamenuofexistingmembers:
EDIT---ABCDE.MOON.DATA7-----------------------ROW00001OF00004
COMMAND===>SCROLL===>PAGENAMEVV.MMCREATEDCHANGEDSIZEINITMODIDARMSTRON01.0091/08/0791/08/0717:43220ABCDE
CHEESE01.0091/08/0791/08/0717:26220ABCDE
sCRATER01.0091/08/0791/08/0717:13110ABCDEMOUNTAIN01.0091/08/0791/08/0717:14110ABCDE**END**
Beforetheeditorcanbeusedtoenterdataintoanewdataset,thedatasetmustexistasanemptyfile.ISPFoption3.2ortheTSOcommandALLOCATEmaybeusedtocreateanewemptydataset.
RegardlessofwhetheryouareusingISPFoption2or3.4,therearefivepossibleeditingsituations:
??Editanexistingsequentialdataset.
??Editanewsequentialdataset;anemptysequentialdatasetmustbecreated
priortoediting.
??
Editanexistingmemberinanexistingpartitioneddataset.
??Editanewmemberinanexistingpartitioneddataset.
??Editanewmemberinanewpartitioneddataset;anemptypartitioneddataset
mustbecreatedpriortoediting.
7/31/2019 Fundamentals of TSO
36/84
Inonlytwosituationsisitnecessarytocreateanew,emptydatasetpriortoinvokingtheeditor.Also,notethedifferencebetweeneditinganewmemberofanexistingdatasetandeditinganewmemberofanewdataset;onlythelatterrequiresanew,emptydatasettobecreated.(ISPFoption2isofteneasierthan3.4forcreatingamemberinanemptypartitioneddataset.)
Asageneralrule,itispreferabletocreateanewfileasamemberofapartitioneddatasetthantocreateitasasequentialdataset.Variouseditingtasksaresimplerwhenworkingwithpartitioneddatasets;andsomecommands,suchascopyingspecificlinesfromonefiletoanother,arenotpossiblewithsequentialdatasetsbutarewith
MVS-17-TSO
7/31/2019 Fundamentals of TSO
37/84
FundamentalsofTSO
partitioneddatasets.Sequentialdatasetsutilizediskspaceinefficientlyforsmallfilesandaremorecumbersometocreate.
7.BATCHJOBJCLFullyspecifiedJCL(JobControlLanguage)isrequiredforbatchjobssubmittedfromTSO.(FromWYLBUR,eitherfullyspecifiedJCLorpartialJCLisrequired.)Theterm"fullyspecifiedJCL"refersprimarilytothefollowingJCLstatements:
JCLStatementUsagenote
JOBrequiredROUTEoptionalJOBPARMoptionalTAPESoptionalOUTPUToptionalJCLLIBoptional
TheabovestatementsareinadditiontoanyotherJCLstatementsnormallyusedinabatchjob.Theotherstatements,primarilyEXECandDDstatements,arethoserequiredbythesoftware(SAS,FORTRAN,etc.)beingexecutedinthebatchjob.
TheSUBMITcommandisusedtosubmitthebatchjobforprocessing.Theoutputfromthebatchjobmaybeprinted,purged,orkeptinthequeuetobeviewedattheterminal.JCLstatementsdeterminewhethertheoutputisprintedorkeptinthequeueforviewing.TheIOFfacilityisusedtoviewtheoutput,changeprintdestinations,purge
output,etc.Theeditmacro%MAKEJOBmaybeusedtocreateafullyspecifiedJOBstatement.
ThefollowingillustratespropersyntaxoftheaforementionedJCLstatements:
//ABCDE###JOB(12345),NOTIFY=ABCDE,MSGCLASS=A,REGION=8M,TIME=(1,30)/*ROUTEPRINTKEEP
7/31/2019 Fundamentals of TSO
38/84
defaultprintdestinationisKEEP,thisstatementisusuallyomitted.??ReplaceLINESvalueontheJOBPARMstatementwithalargervalue,ifnecessary.Ifyourprintrequirementsarelessthen10thousandlines,thisstatementisusuallyomitted.
MVS-18-TSO
7/31/2019 Fundamentals of TSO
39/84
FundamentalsofTSO
??ReplacetheTAPESvaluewithnumberofneededconcurrenttapedrives(nottapevolumes).If
youarenotusingtapes,thisstatementisomitted.
??ReplacetheROOMvalueontheOUTPUTstatementifyouhaveanassignedsecuritybin.This
statementisusuallyomitted.
??ReplacetheprocedurelibrarynameSOME.PROC.LIBontheJCLLIBstatementwiththenameof
theprocedurelibrarytobeused.Thisstatementisusuallyomitted.
7.1JOBStatementTheJOBstatementisrequired;however,manyoftheparameters(positionalandkeyword)maybeomitted.Theonlyrequireditemsarethejobnameandtheaccountnumber.IntheexampleshownbelowABCDE###isthejobnameand12345istheaccountnumber.
//ABCDE###JOB(12345),NOTIFY=ABCDE,REGION=4M,TIME=(0,5)
AnalternativemethodforspecifyingaJOBstatementisavailable,thoughlimitedinfunctionality.ThismethodrequirestheJOBstatementtobereplacedinitsentiretybyaJCLcommentstatement.AJCLcommentstatementcontains//*incolumns1-3andablankincolumn4.Withthismethod,defaultvaluesarechosenforallparameters.Ajobnameisgeneratedconsistingofyouruseridanduptothreeadditionalcharacters;
thesystempromptsfortheadditionalcharacters.
Note:Theeditmacro%MAKEJOBisavailableinaneditingsession.Whenenteredontheeditorcommandline,%MAKEJOBinsertsafullyspecifiedJOBstatementintothefilebeingedited.AftertheJOBstatementisinserted,youcanadjusttheREGIONandTIMEvaluesifnecessary.
Thejobname(required)beginsincolumn3,is5to8charactersinlength,andisfollowedbyatleastoneblank.Thefirstpartofthejobnamemustbetheuserid
.Theremainingcharacters,ifany,maybealphanumeric(A..Z,0..9)ornational(@#$)characters.
Whenabatchjobissubmittedandthejobnameconsistsoftheuseridonly,thesystempromptsforadditionaljobnamecharacters.TheJOBstatementshouldhaveenoughspaceafterthejobname(orattheendofthefirstlineoftheJOBstatement)toallow
7/31/2019 Fundamentals of TSO
40/84
insertionofadditionaljobnamecharacters,elsetruncationofthejobnamewilloccur.)
7.1.1PositionalParametersPositionalparametersappearontheJOBstatementafterthewordJOB,beforeanykeywordparameters,andmustappearinaspecificsequence.
Theaccountingparameter(required)isthefirstpositionalparameterontheJOBstatement.Theaccountnumber(required)isthefirstvalueintheaccounting
MVS-19-TSO
7/31/2019 Fundamentals of TSO
41/84
FundamentalsofTSO
parameter.Theaccountnumbermustbevalidfortheuseridspecifiedinthejobname.Aroomcodemayappearaftertheaccountnumber.(Historically,theroomcodeintheJOBstatementwasusedasaplotdistributioncodeatASU.)Acommaisusedtoseparatetheaccountnumberfromtheroomcode.Parenthesesareusedtoenclosetheaccountingparameter.Ifonlytheaccountnumberispresent,theenclosingparenthesesareoptional.
Thenameparameter(optional,notshown)isthesecondpositionalparameter.Itisenclosedwithinsinglequotemarksandmaycontainupto20charactersofidentifyinginformation,suchastheprogrammer'sname.
7.1.2KeywordParametersAllkeywordparameters(identifiablebyanequalsign)maybespecifiedinanyorderontheJOBstatementandmustappearafterallpositionalparameters.Thereare
severalkeywordparameters,allofwhichareoptional.Onlythecommonlyusedparametersaredescribedinthisdocument.
TheNOTIFYkeywordparameter(optional)identifiesauseridtowhichajob-completionmessageshouldbesentoncethebatchjobcompletes.ItisnotnecessaryfortheNOTIFYuseridtomatchthejobnameuserid,thoughthisisusuallythecase.(TheWYLBURequivalent,//EXECWNOTIFY,shouldnotbeused.)
TheREGIONkeywordparameter(optional)declarestheamountofvirtualmemory
neededbythebatchjob.Ifthesystemdefaultissufficient,thisoperandmaybeomitted.
TheTIMEkeywordparameter(optional)declarestheamountofCPUtimeneededbythebatchjob.Ifthesystemdefaultissufficient,thisoperandmaybeomitted.
TheMSGCLASSkeywordparameter(optional)definestheprintclassfortheJCLlistingandmessages.MSGCLASS=ZmaybeusedtodiscardtheJCLlistingandmessages;however,thisisnotrecommendedsincemanyerrormessageswouldbediscarded,too.IfthedefaultMSGCLASSforyouruseridissufficient,thisoperandmay
beomitted.
YoumaydisplayorchangethedefaultMSGCLASS.ThefollowingLISTUSERcommanddisplaysthedefaultMSGCLASSforuseridABCDE.ThefollowingALTUSERcommandchangesthedefaultMSGCLASStoA.ThesecommandsareTSO/RACFcommands;theTSOcommandprefixisrequiredifthecommandsareenteredonanon-TSOcommandline.
COMMAND===>TSOLISTUSERABCDENORACFTSOCOMMAND===>TSOALTUSERABCDETSO(MSGCLASS(A))
7/31/2019 Fundamentals of TSO
42/84
MVS-20-TSO
7/31/2019 Fundamentals of TSO
43/84
FundamentalsofTSO
TheMSGLEVELkeywordparameter(optional,notshown)determinestheamountofjobcontrolinformation(JCL,messages)tobedisplayedinthejoblisting.Ifthesystemdefaultissufficient,thisoperandmaybeomitted.Theparametervaluecontains2numbersseparatedbyacommaandisenclosedinparentheses,forexample,MSGLEVEL=(2,1).Thefirstnumberappliestostatements,thesecondtomessages.
Statements:
0OnlyJOBstatements
1AllJCLandprocedurestatements
2OnlyJCLstatements
Messages:
0OnlyJCLmessages
1JCL,JES,andoperatormessages
RefertotheIBMJCLReferencemanualforinformationregardingotherkeywordparametersandforadditionalinformationonparameterspreviouslymentioned.
7.2ROUTEStatementTheROUTEstatementmaybeomittedifthedefaultprintjobdestinationforyouruseridissufficient.(UsetheLISTUSERcommandtodisplaythedefaultprintdestinationforyouruserid;usetheALTUSERcommandtoestablishadifferentdefaultprintdestination.)TheprintdestinationKEEPisrecommended.ItissimilartotheWYLBURFETCHqueue;i.e.,thebatchjoboutputiskeptintheprintqueuefor
viewing.(IOFmaybeusedtoviewthebatchjoboutputandtoprintorpurgeit.)
ThefollowingLISTUSERcommanddisplaysthedefaultprintdestination(andseveralotheritems)foruseridABCDE.ThefollowingALTUSERcommandchangesthedefaultprintdestinationtoKEEP(andmaybeusedtochangeotheritems,too).ThesecommandsareTSO/RACFcommands;theTSOcommandprefixisrequiredifthecommandsareenteredonanon-TSOcommandline.
COMMAND===>TSOLISTUSERABCDENORACFTSOCOMMAND===>TSOALTUSERABCDETSO(DEST(KEEP))
7.3JOBPARMStatementTheJOBPARMstatementsetsthemaximumnumberofprintlinesandmaybeomittedifthedefaultLINESvalueissufficient.LINES=10isthedefault,whichrepresents10thousandprintlines.
/*JOBPARMLINES=10
7/31/2019 Fundamentals of TSO
44/84
MVS-21-TSO
7/31/2019 Fundamentals of TSO
45/84
FundamentalsofTSO
7.4TAPESStatementTheTAPESstatementisusedtoidentifythenumberofconcurrenttapedrives(nottapevolumes)neededbyyourbatchjob.Themaximumis4.Ifyouarenotusingtapes,youshouldomitthisstatement.
/*TAPES1
7.5OUTPUTStatementPrintedoutputfrombatchjobsaresortedalphabeticallybythelastletteroftheuseridandplacedonshelvesinthecomputingsites,unlessasecuritybinnumberappearsonthebannerpage.Ifyouhaveanassignedsecuritybin,usetheOUTPUTstatementtoidentifythesecuritybinnumber.(TheOUTPUTstatementappearsaftertheJOBstatement.)Anyprintedoutputwithabinnumberwillbeshelvedinthecorrespondingsecuritybin.Inthefollowingexample,thesecuritybinisC2;replaceC2withyour
assignedsecuritybinnumber.
//BANNEROUTPUTDEFAULT=YES,JESDS=ALL,ROOM=#C2
7.6JCLLIBStatementTheJCLLIBstatementidentifiesoneormoreprocedurelibrariestobesearchedinadditiontothestandardsystemprocedurelibraries.Whenspecifyingmorethanoneprocedurelibrary,placeacommabetweeneachlibrarynameandenclosetheentirelistinparentheses.
ProcedurelibrarieslistedontheJCLLIBstatementaresearchedintheordertheyappearonthestatementandaresearchedbeforethestandardsystemlibraries.ThesearchorderforstandardsystemlibrariesisSYS1.ASU.PROCLIBandSYS1.PROCLIB.(SYS1.ASU.PROCLIBbecomespartofthestandardsystemsearchordereffectiveDec.21,1998.)
//JCLLIBORDER=SOME.PROCLIB//JCLLIBORDER=(MAIN.PROC.LIB,ANOTHER.LIB.NAME)
8.BATCHJOBSUBMITTALTheSUBMITcommandisusedtosubmitbatchjobsfromTSOtotheMVSbatchsystemforprocessing.TheprocedureisnearlyidenticaltothatusedbyWYLBUR;theprimarydifferencebeingTSOrequiresfullyspecifiedJCL.
Theoutputfromthebatchjobmaybeprinted,purged,orkeptinthequeuetobe
7/31/2019 Fundamentals of TSO
46/84
viewedattheterminal.JCLstatementsdeterminewhetherthebatchjoboutputis
MVS-22-TSO
7/31/2019 Fundamentals of TSO
47/84
FundamentalsofTSO
printedorkeptinthequeueforviewing.TheIOFfacilityisusedtomonitorbatchjobs,viewtheoutput,changeprintdestinations,purgeoutput,etc.
ThereareactuallytwoformsoftheSUBMITcommand:thenativeTSOcommandand
theSPF/PDFeditorsub-command.CommandtypeSyntaxSPF/PDFeditorsub-commandSUBMITnativeTSOcommandSUBMITdsnameSUBMIT(dsnamedsname...)
8.1SPF/PDFSUBMITCommandTheSPF/PDFSUBMITcommandisusedonlywhentheeditorisdisplayingafilewhosecontentsisthebatchjobtobesubmitted.Inotherwords,usetheeditortodisplaythefileyouwanttosubmitforbatchprocessing.
Oncethefiletobesubmittedisdisplayedonthescreen(andafteryouhavemadeanydesiredchanges),entertheSUBMITcommandontheeditorcommandline:
COMMAND===>SUBMIT
Theentirefileissubmittedforprocessing,unlessalinerangeoptionisspecifiedtocauseonlyaportionofthefiletobesubmitted.
8.2TSOSUBMITCommandTheTSOSUBMITcommandmaybeusedatanytime,evenwhentheeditorisbeingused.TheoperandforthisSUBMITcommandisaparenthesizedlistcontainingthenamesofthedatasetstobesubmittedforbatchprocessing.Ifonlyonedatasetnameis
present,theenclosingparenthesesmaybeomitted.Anynon-quoteddatasetnameisassumedtohave"CNTL"asthelastqualifier;however,ifnosuchdatasetexiststhenthedatasetnamewithout"CNTL"isused.
Forexample,assumingtheuseridisABCDEandthejobtobesubmittedisthememberMYJOBindatasetABCDE.TSOLIB.CNTL,thecommandtosubmitthejobis:
COMMAND===>TSOSUBMITTSOLIB(MYJOB)
Note:TSOfirstsearchesforTSOLIB.CNTL(MYJOB)andthenforTSOLIB(MYJOB).TSO
submitsthefirstonefound.
NotethewordTSOintheabovecommand.ThiswordisrequiredasacommandprefixforanyTSOcommandenteredonanISPFcommandlineoranSPF/PDFeditor
MVS-23-TSO
7/31/2019 Fundamentals of TSO
48/84
FundamentalsofTSO
commandline.IfaTSOcommandisenteredonaTSOcommandlineorontheCOMMANDscreenofISPF(option6ontheprimarymenu),thecommandprefixisnotrequired.
AcommoninstanceofwhentousethenativeTSOcommandwithmultipledatasetnamesiswhenthebodyofthebatchjobiscontainedinonefilebuttheJCLJOBstatement(andperhapsotherJCLstatements)areinaseparatefile.
COMMAND===>TSOSUBMIT(TSOLIB(JCL)TSOLIB(PROG1))
NotetheuseofparenthesesenclosingthedatasetnamesandtheuseoftheTSOcommandprefix.
AcommonmistakemadewiththeTSOSUBMITcommandoccurswhenoneofthefilesbeingsubmittedisalsobeingedited.Unlike,theSPF/PDFSUBMITcommand,theTSOSUBMITcommandusesthecontentsofthefileasitcurrentlyexistsondisk.AnyeditingchangesmadetothefiledonotparticipateintheTSOSUBMITunlessthe
updatedfileissavedpriortosubmission.
Besidessyntax,thereisanotherdifferencebetweentheeditorSUBMITcommandandtheTSOSUBMITcommand.TheTSOSUBMITrequiresthedataset(s)tohavecard-imageformat(i.e.,RECFMFBandLRECL80);theeditorSUBMITallowsfixedorvariableformat(RECFMFBorVB)andanylogicalrecordlength.(Actually,theeditorcommandcopiesthedisplayeddatasetintoatemporarydatasethavingcard-imageformatandthenusestheTSOcommandtosubmitthetemporarydatasetforprocessing.)
ForeitherSUBMITcommand,ifthejobnameofabatchjobconsistsoftheuseridonly,thesystempromptsforadditionaljobnamecharacters.Oneormorenumbersarerecommendedastheadditionalcharacters.(Themaximumsizejobnameiseightcharacters.Iftheuseridisfivecharactersthenonetothreeadditionalcharactersshouldbetypedattheprompt.)
9.IOF(FetchingBatchJobOutput)ThefacilitywhichprovidesmonitoringandcontrolofMVSbatchjobsiscalledIOF(InteractiveOutputFacility).IOFprovidesfacilitiesformonitoringtheprogre
ssofbatchjobsqueuedforexecution,executing,andcompleted.IOFcanalsobeusedtocancelactivejobsandtoreview,print,purge,orredirectoutputfromjobsthathavecompleted.IOFperformsthesamefunctionsastheWYLBURcommandsCANCEL,FETCH,LOCATE,PRINT,ROUTE,andPURGE.
MVS-24-TSO
7/31/2019 Fundamentals of TSO
49/84
7/31/2019 Fundamentals of TSO
50/84
FundamentalsofTSO
9.1InvokingIOFIOFisinvokedbychoosingoptionIfromtheISPFmainmenu.Onceselected,ascreensimilartothefollowingappears.(ThefirsttimeyouuseIOFaone-timescreenwillappearwhichtellsyouhowtocustomizeIOF.PressEntertocontinue.)
IOFJOBLISTMENUCOMMAND===>SCROLL===>PAGE------------------------RUNNINGJOBS---------------------------------JOBNAME---JOBID--ACT-STA-SYID----CPU---I/O---STEP-----PROCSTEP-SWP_1ABCDET04982MVS2:028.79ISPFPDFSIN-------------------------OUTPUTJOBS---------------------------------JOBNAME---JOBID--ACT-STA-OWNDER---DEST/DEVICE---RECS-------------_2ABCDE36J05240ABCDEUCC1937_3ABCDE41J05311ABCDEKEEP2307
F1=HELPF2=SPLITF3=ENDF4=RETURNF5=IFINDF6=FIND'F7=UPF8=DOWNF9=SWAPF10=LEFTF11=RIGHTF12=RETRIEVE
Tolookatthebatchjoboutput,tabtothejobofinterestandtypeBtothele
ftofthejobnameandpressenter.
Toprintthebatchjob,tabtothejobofinterestandthencetothedestinationfield;typeaprinternameovertheexistingdestinationandpressenter.
ToexitIOF,presstheENDkey(PF3)oneormoretimes.
TogettheIOFmainmenu,type/onthecommandlineandpressENTER.Aportionofthemainmenuisshownbelow.
IOFUSEROPTIONMENUCOMMAND===>Selectanoption.blank=YourjobsG=OutputgroupsQT=QuicktutorialI=InputjobsJ=AlljobsmenuHELP=HelpR=RunningjobsH=JobswithheldoutputO=OutputjobsP=ProfileJOBNAMES===>
9.2On-lineHelpandTutorialOn-lineHelpisavailablewithinIOF.TypeHELPonanycommandlinewithinIOForpresstheHELPkey(PF1),andahelpscreenwillappear.InvokingHelpfromthe
IOF
MVS-25-TSO
7/31/2019 Fundamentals of TSO
51/84
7/31/2019 Fundamentals of TSO
52/84
printfileswithinthebatchjob(recommended),usetheP?prefixcommandontheIOFJobSummarypanelforthedesiredprintfiles.P?displaysanotherpanelcontainingaprintdestinationfield;typeavaliddestinationonthislatterpaneltoprinttheselected
MVS-26-TSO
7/31/2019 Fundamentals of TSO
53/84
FundamentalsofTSO
file.(Bydefault,printingtheentirejobresultsintheoutputjobbeingremovedfromthemainframeprintqueue.PrintingselectedportionswithP?doesnotremovetheoutputjobfromthemainframeprintqueue.)
Note:IftheprintdestinationisanASUIT-providedprinterinapublicsite,theprintjobisnotphysicallyprinteduntilafterpaymentismadefortheprintedoutput.Paymentmustbemadewithintwohoursofinitiatingtheprintrequestelsetheprintrequestispurgedfromtheprintersqueue.Iftheprintrequestispurged,anotherprintrequestcanbeinitiatedprovidedtheoutputjobstillexistsinthemainframeprintqueue.(TheP?methodisrecommendedforprintingfilesbecauseP?doesnotremoveoutputjobsfromthemainframeprintqueue.)
RefertotheIOFon-lineHelpandtutorialforinformationonothercommands.
9.6HeldOutputAnyprintfilesusingSYSOUTclassWareconsideredHeldOutput.(SYSOUTclassWisthestandardTSOHoldOutputprintclassatASU.)PrintfilesusingprintclassesotherthanWappearinOutputJobs.UseofSYSOUTclassWisanalternativemethodofkeepingoutputintheprintqueueforsubsequentbrowsing.UseofprintdestinationKEEP,whichaccomplishesthesamething,isrecommendedsinceitallowsallprintfilestoappearonthesamedisplayscreen.
Toprintaheldoutputfile,typeavalidclassletter(typicallyA)overtheexistingclassletterandfollowtheprocedurelistedintheprevioussectionforOutputJobs.RefertotheIOFon-lineHelpandtutorialforinformationonothercommands.
9.7SaveBatchOutputtoDiskSomeportionorallofacompletedbatchjobmaybesavedtodisk.OntheIOFJobListMenu,entertheprefixcommandSintheleftmostpositionoftheIOFlinecorrespondingtothejobtobeactedupon.ThiscausestheIOFJobSummaryscreento
bedisplayed.
Tosavetheentirejobtodisk,enterthefollowingthreeprimarycommandsonthecommandline.(ReadthisentiresectionbeforeusingSD.)
SD/*Displaymenuwhereontheoutputdiskfileischosen*/SNAP/*Savetheentirebatchjobtodisk*/SNAPCLOS/*Closethediskfile*/
7/31/2019 Fundamentals of TSO
54/84
Theprocesstosaveoneormoreprintfilestodiskissimilartosavingtheentirejobtodisk,excepttheSNAPprimarycommandisreplacedbyoneormoreNprefixcommands.TheNprefixcommandistypedintheleftmostpositionoftheIOFline
MVS-27-TSO
7/31/2019 Fundamentals of TSO
55/84
FundamentalsofTSO
correspondingtotheprintfiletobeactedupon.Thefollowingsamplesavesthreeprintfilestodisk.(ReadthisentiresectionbeforeusingSD.)
SD/*Displaymenuwhereontheoutputdiskfileischosen*/N/*Prefixcommandtosaveprintfiletodisk*/N/*Prefixcommandtosaveprintfiletodisk*/N/*Prefixcommandtosaveprintfiletodisk*/SNAPCLOS/*Closethediskfile*/
TheSDcommandwithnooperandscausestheIOFSnapDataSetOptionsscreentobedisplayedwhereonyouchoosethediskfileintowhichtheoutputistobesaved.Thedefaultdatasetnameisjobname.IOFLIST.Youcanchooseanothernameorchangeothersettingsassociatedwiththedataset.Thedatasetwillbeautomaticallycreatedifitdoesnotalreadyexist.
TheSDcommandwiththeDATAoperand,whichidentifiesanexistingdatasetfor
savingtheoutput,bypassesdisplayoftheIOFSnapDataSetOptionsscreen.Thepreviouscontentsofthedatasetareoverwritten.Thesyntaxisasfollows:
SDDATA(datasetname)/*Identifyoutputdiskfile*/
10.RACF(DiskandTapeSecurity)RACF(ResourceAccessControlFacility)isusedtodefineaccountattributes,providedatasetsecurity,andcontrolaccesstovarioussystemcomponents.Securityisbasedonuserids.
RACFcanbeaccessedviaISPFoption9(IBMSOFTWARE)orascommandsontheTSOorISPFcommandline.IfaccessedviaISPF,aRACFtutorialisavailable;selectoptionTontheRACFmainmenu.(RACFcommandsenteredonanISPFcommandlineshouldbeginwiththewordTSO.)
FromtheRACFmenuinISPF,option1isusedtochangediskfilesecurity,option2isusedfortapevolumesecurity,andoption4isusedtodisplayorchangevariousattributesforyouraccount.Refertotheon-linehelpandtutorialforinformationonhowtousetheRACFpanels.
10.1ProfileNamesInformationcontainedintheRACFdatabasedefinesthesecurityforeverythingwithinthesystem.Eachentryinthedatabaseiscalledaprofile,andeachentryhasaname.Typically,adatasetname(orapatternwhichmatchesadatasetname)oratapevolumeserialnumberisusedasthenameforaRACFprofile.
7/31/2019 Fundamentals of TSO
56/84
MVS-28-TSO
7/31/2019 Fundamentals of TSO
57/84
FundamentalsofTSO
TheRACFcommandsandmenusassumethatdatasetnamesconformtotheTSOnamingconvention.AnydatasetnameswhichdonotconformtotheTSOnamingconventionorforwhichthefirstqualifierdoesnotmatchyourPREFIX(typicallyyouruserid)shouldbeenclosedinquotes.
Initsstandardconfiguration,RACFdoesnotworkwithnon-TSOnamingconventions.AtASU,RACFinternallygivesTSO-typenamestoRACFprofilesassociatedwithWYLBUR-typenames.Forexample,ifaRACFprofilewerecreatedforthedataset'WYL.AB.CDE.DATA',RACFwouldcreateaprofilenamed'ABCDE.WYL.DATA.Generally,youneednotbeawareofthedifference;however,whendisplayingalistofexistingprofiles,theRACFgeneratednamesarebedisplayedinsteadoftheWYLBUR-typenames.
10.2DiskFileSecurityYoucangiveoneormoreuseridsaccesstooneormorediskdatasets.Thedataset(s)maybeidentifiedbyaspecificname(onedataset)orbyapatterncontaininga
sterisks(manydatasets).ThedatasetnameorpatternisalsotheRACFprofileentryname.Forpatternmatching,asingleasterisk(*)matchesonequalifier;doubleasterisks(**)matchmultiplequalifiers.
'ABCDE.PROJECT.DATA'/*matchesonedataset*/'ABCDE.*.SAS'/*manydatasetswiththreequalifiers*/'ABCDE.PROJECT.*'/*manydatasetswiththreequalifiers*/'WYL.AB.CDE.**'/*alldatasetswithWYLBUR-typenames*/'ABCDE.**'/*alldatasets*/
Note:BecauseRACFinternallygivesTSO-typenamestoRACFprofilesassociatedwithWYLBUR-typenames,thelastexamplegivenabove('ABCDE.**')wouldmatchalldatasetnames,bothTSO-andWYLBUR-typenames.
10.3TapeVolumeSecurityTapesecurityisappliedtotheentiretaperatherthantoindividualfiles.ThenameofatapeRACFprofileisthetape'svolumeserialnumber.(Note:Tapeprofilesareknownas"generalresources"andbelongtothe"tapevol"class.Thisinformationisne
ededwhenusingtheISPFmenusforchangingsecurityassociatedwithtapevolumes.)
10.4LISTUSERTheLISTUSERcommanddisplaystwoseparatecomponents,oneforRACFandtheotherforTSO.Thecommandcandisplayeitherorbothcomponents.
MVS-29-TSO
7/31/2019 Fundamentals of TSO
58/84
7/31/2019 Fundamentals of TSO
59/84
FundamentalsofTSO
LISTUSERuserid/*listRACFinformationonly*/LISTUSERuseridNORACFTSO/*listTSOinformationonly*/LISTUSERuseridTSO/*listRACFandTSOinformation*/
10.4.1DisplayDiskQuotaAsamplelistingofthefirstfewlinesoftheRACFinformationisshownbelow.DiskquotainformationisshownontheINSTALLATION-DATAline.ThenumberassociatedwithMAXistheuserid'smaximumdiskspacequotaintracks;thenumberassociatedwithUSEDisthenumberoftrackscurrentlyusedbytheuserid.USER=?????NAME=?????????OWNER=?????CREATED=89.140DEFAULT-GROUP=USERSGRP0PASSDATE=91.190PASS-INTERVAL=90ATTRIBUTES=NONEREVOKEDATE=NONERESUMEDATE=NONELAST-ACCESS=91.247/18:55:48CLASSAUTHORIZATIONS=NONEINSTALLATION-DATA=MAX(00100)USED(00000025)NO-MODEL-NAMELOGONALLOWED(DAYS)(TIME)
ANYDAYANYTIME
Note:AsofApril2002,diskquotasarenotenforced.Theinformationhasbeenleftinthisdocumentforhistoricalpurposes.
10.4.2DisplayAccountNumberAsamplelistingoftheTSOinformationisshownbelow.TheitemsofnotearethedefaultMSGCLASSforbatchjobs(MSGCLASS),thedefaultSYSOUTclassforprintedoutput(SYSOUTCLASS),thedefaultbatchjobprintdestination(DEST),theaccount
number(ACCTNUM),thedefaultdiskunitforcreatingnewdiskdatasets(UNIT),theamountofvirtualmemorybeingused(SIZE),andthemaximumamountofvirtualmemoryavailablefortheterminalsession.TSOINFORMATIONACCTNUM=12345DEST=UCC1HOLDCLASS=WMSGCLASS=APROC=ISPFPDFSSIZE=0004096MAXSIZE=0008192SYSOUTCLASS=A
UNIT=RESRCH
10.5ALTUSERTheALTUSERcommandmaybeusedtochangecertainitems(butnotall)intheRACFandTSOcomponentsdisplayedbytheLISTUSERcommand.Severalofthemoreusefulcommandsareshownbelow:
7/31/2019 Fundamentals of TSO
60/84
MVS-30-TSO
7/31/2019 Fundamentals of TSO
61/84
FundamentalsofTSO
ALTUSERuseridTSO(DEST(KEEP))/*Setprintdestto"fetch"queue*/ALTUSERuseridTSO(MSGCLASS(A))/*SetMSGCLASSforbatch*/
ThereisnoneedtochangePROCorSIZEsincethesetwowillnottakeeffectuntilthenextlogon,atwhichpointyoucanalterthemonthelogonscreen.
11.TSOCOMMANDSTSO"commands"maybebuilt-incommands,programs,orexecs.Regardlessofthetype,thecommandshavethesamegeneralformatandareenteredontheTSOcommandline.ThecommandsmayalsobetypedontheISPFcommandlinebutmusthavethewordTSOappendedtothefrontofthecommand;thiswordinformsISPFthatthecommandshouldbesubmittedtoTSOforprocessing.
(ISPFalsohasasetofcommands.ThesecommandscanonlybeenteredonanISPFcommandline,notonaTSOcommandline.)
11.1ALLOCATETheALLOCATE(orALLOC)commandisusedtoallocatefiles.ItperformsthesamefunctionasaJCLDDstatement.Itassociatesaddname(DD)withadatasetname
(DSN).WithsomesoftwaretheALLOCcommandisoptional.Forexample,SASandFORTRANareabletoreadorwritefileswithorwithoutusingtheALLOCcommand;othersoftwareneedtheALLOCcommand.
DatasetnamesintheALLOCstatementmaybefullyqualified,and,ifthedatasetispartitioned,aparenthesizedmembernamemaybeappendedtothedatasetname.Singlequotemarksshouldenclosefullyqualifieddatasetnames.Withouttheenclosingquotemarks,thesystemwillassumethatthecurrentPREFIX(typicallyyouruserid)shouldbeaffixedtothedatanametoformafullyqualifieddatasetna
me.Forinputfiles,alistofdatasetnamesmaybeusedtologicallyconcatenatethefilesintoonelargerfile.
Writetoanexistingdataset:ALLOCDD(ddname)DSN(datasetname)OLD
Readfromanexistingdataset:ALLOCDD(ddname)DSN(datasetname)SHRREUSE
Readfromanexistingdataset(usedbyFORTRANprograms):ALLOCDD(ddname)DSN(datasetname)SHRREUSEINPUT
Writetoanewsequentialdataset:
ALLOCDD(ddname)DSN(datasetname)NEWCATALOGREUSE
SPACE(primarysecondary)TRACKSUNIT(RESRCH)RELEASE
7/31/2019 Fundamentals of TSO
62/84
RECFM(FB)LRECL(80)BLKSIZE(7440)
MVS-31-TSO
7/31/2019 Fundamentals of TSO
63/84
FundamentalsofTSO
Writetoanewpartitioneddataset:
ALLOCDD(ddname)DSN(datasetname(member))NEWCATALOGREUSESPACE(primarysecondary)TRACKSDIR(blocks)UNIT(RESRCH)RECFM(VB)LRECL(259)BLKSIZE(7476)
Writetotheprinter:ALLOCDD(ddname)SYSOUT(A)DEST(destination)
Readfromorwritetotheterminal:ALLOCDD(ddname)DSN(*)
Readfromorwritetoa"dummy"file:ALLOCDD(ddname)DUMMY
??ALLOCisthecommand.??DD(...)identifiestheddname.??DSN(...)identifiesthedatasetname(s)and/ormember(s).DSN(*)represents
the
terminal.??OLDindicatesthedatasetexistsandwillbereadand/orwritten.??SHRindicatesthedatasetexistsandwillberead.??INPUTisusedalongwithSHRbutisonlyneededbyFORTRANprograms.??NEWindicatesthedatasetdoesnotyetexistbutisbeingcreated.??CATALOGisusedalongwithNEWtocataloganewdataset.??REUSEindicatesthatiftheddnameisalreadyinuse,theexistingallocation
shouldbefreedandtheddnamereused.
??SPACEindicatesthesizeofanewdataset;"primary"istheinitialsizeand"secondary"istheincrementneedediftheprimarysizeistoosmall.??TRACKSindicatesthatSPACEisallocatedintracks.CYLisusedtoallocatespaceincylinders.??DIRindicatesthatapartitioneddatasetisbeingcreatedand"blocks"indicates
thenumberofdirectoryblocksneeded.??RELEASEreturnsunusedtracksorcylinderstothesystem.??UNITindicatesthediskvolumestocontainnewdatasets.??RECFMistherecordformat.??LRECListhelogicalrecordlength.
??BLKSIZEistheblocksizeofthedataset.??SYSOUTindicatesaprinterfile.??DESTindicatestheprintdestination.??DUMMYindicatesthefileisadummyfile.
11.2CALLCALLisusedtoexecutealoadmodule,thebinaryexecutableformofaprogramwhichhaspreviouslybeenlink-edited.Ifthefirstqualifierofthedatasetnamecon
7/31/2019 Fundamentals of TSO
64/84
tainingtheloadmoduledoesnotmatchyourPREFIX(typicallyyouruserid)orifthelastqualifierisnotLOAD,thedatasetnamemustbefullyqualifiedandenclosedwithinsingle
MVS-32-TSO
7/31/2019 Fundamentals of TSO
65/84
FundamentalsofTSO
quotesonthecommandline;otherwise,boththefirstandlastqualifiershouldbeomittedonthecommandline.
Executealoadmoduleandpassruntimeparameters:CALL'fulldatasetname(member)''parameters'
Executealoadmodulewithashortenedname:CALLshortname(member)
11.3DELETEDELETEisusedtodeleteadataset.ISPFalsohasseveralmethodstodeleteadataset.
Deleteamember:DELETEdatasetname(member)
Deleteadataset:
DELETEdatasetname
11.4EXEC11.4.1ExplicitExecsEXECisusedtoexplicitlyexecuteaCLISTorREXXexec.(CLISTsandREXXexecsmayalsobeexecutedimplicitlyifthelibrariescontainingtheCLISTsandREXXexecsareassignedtotheddnamesSYSPROCorSYSEXEC.)
YoumaycreateyourownexecsusingeitherREXXorCLIST,butREXXisrecommended.ItishighlyrecommendedthatthefirstlineofanyREXXexecbegin
withthecomment/*REXX*/.Dependingonthemethodusedtoinvoketheexec,thecommentissometimesrequired.
TheEXECcommandrequiresadatasetname(includingamembernameifnecessary).IfthedatasetnameisfullyqualifiedorifthefirstqualifierofthedatasetnamedoesnotmatchyourPREFIX(typicallyyouruserid)orifthelastqualifierofthedatasetnameisnotCLISTorEXEC,thedatasetnamemustbeenclosedinparenthesis.
IfthefirstdatasetnamequalifierisyourPREFIXandthelastqualifierisCL
ISTorEXEC,thefirstandlastqualifiersareomitted.Theremainingportionofthedatasetname,ifany,andthemembernameisspecified.
ExecuteaCLIST;for"shortnames",thelastqualifiermustbeCLISTand
mustbeomitted:
EXEC'fullname(member)''parameters'
7/31/2019 Fundamentals of TSO
66/84
EXEC'fullname(member)''parameters'CLIST
EXECshortname(member)'parameters'
EXECshortname(member)'parameters'CLIST
MVS-33-TSO
7/31/2019 Fundamentals of TSO
67/84
FundamentalsofTSO
ExecuteaREXXexec;for"shortnames",thelastqualifiermustbeEXECandmustbeomitted;forthetwoexampleswithoutthe"EXEC"keywordattheend,thefirstlineoftheexecmustcontainacommentcontainingthewordREXX(/*REXX*/):EXEC'fullname(member)''parameters'EXEC'fullname(member)''parameters'EXECEXECshortname(member)'parameters'EXECshortname(member)'parameters'EXEC
??The'parameters'maybeomittedfromthecommandlineifnoparametersaretobepassedtotheCLISTorREXXexec.??TheCLISTkeywordattheendofthecommandlineshouldonlybespecifiedforCLISTs.??TheEXECkeywordattheendofthecommandlineshouldonlybespecifiedforREXXexecs.
??IfneitherCLISTnorEXECisusedattheendoftheline,CLISTisassumedasthelastqualifierfora"shortname";however,theprocessorexaminesthefirstline
ofthefiletodeterminewhetheraCLISTorREXXexecisbeinginvoked.Ifthefirstlinecontains/*REXX*/,aREXXexecisassumed;otherwiseaCLISTisassumed.
11.4.2ImplicitExecsCLISTsandREXXexecsmaybeexecutedimplicitly.Inthisinstance,theEXECcommandisnotused;themembernameoftheexecisusedasifitwereacommand.ThisrequiresthattheCLISTorREXXexecsresideinlibrarieswhichareassignedtotheddnamesSYSPROCorSYSEXEC.
ThelibrariesassignedtoSYSPROCmaycontainCLISTSand/orREXXexecs.ThelibrariesassignedtoSYSEXECmaycontainonlyREXXexecs.Therecordformatofthelibrariesmaybefixed(FB)orvariable(VB),butmustmatchtherecordformatofanyexistinglibrariesalreadyassignedtotheddname.Therecordlengthmaybeupto255forfixedformator259forvariableformat,butforfixedformattherecordlengthmustmatchanyexistinglibrariesalreadyassignedtotheddname.
CAUTION:SYSPROCispre-allocatedtonumeroussystemlibraries.IfyouaddanylibrariestoSYSPROC,besuretoincludetheexistingsystemlibrarieswhenreal
locatingSYSPROC.Thesystemlibrariesareincard-image(fixedformatwithrecordlengthof80);anyadditionallibrariesshouldalsobecard-image.
CAUTION:SYSEXECmaybepre-allocatedtovarioussystemlibraries.IfyouaddanylibrariestoSYSEXEC,besuretoincludetheexistingsystemlibrarieswhenreallocatingSYSEXEC.AlllibrariesallocatedtoSYSEXECshouldmatchinrecordformat(and
7/31/2019 Fundamentals of TSO
68/84
recordlengthforfixedformat).Also,SYSEXECwillnotbesearchedforanyREXXexecsunlessSYSEXECsearchingisactivated.TheEXECUTILcommand,describedbelow,isusedtoturnSYSEXECsearchingonoroff.(AtASU,theSYSEXECsearchingisonbydefault.)
MVS-34-TSO
7/31/2019 Fundamentals of TSO
69/84
FundamentalsofTSO
ExecuteaCLISTorREXXexecimplicitly:membernameparameters%membernameparameters
??Theparametersareoptionalandmaybeomitted.
??The%isoptionalandmaybeomitted;however,useof%resultsinslightlyimprovedperformance.Thesystemnormallychecksseverallibrariesbeforetheexeclibraries;the%informsthesystemtocheckonlytheexeclibraries.
11.5EXECUTILEXECUTILdetermineswhetherornottheddnameSYSEXECissearchedforimplicitexecs.Bydefault,onlytheddnameSYSPROCissearchedforimplicitexecs.(SYSEXECmaycontainonlyREXXexecs;SYSPROCmaycontainCLISTSandREXXexecs.)EXECUTILmaybeexecutedatanytimetoactivateordeactivatesearchingofSYSEXEC.
Turnsearchingon:EXECUTILSEARCHDD(YES)
Turnsearchingoff:EXECUTILSEARCHDD(NO)
11.6FREEFREEisusedtodeallocateddnamesordatasets.Whenattemptingtoreallocateaddname,theddnamemustfirstbefreed,elsetheREUSEparameterisneededontheALLOCstatement.Ifthedatasetbeingfreedispartofaconcatenationlist,youshould
freetheddnameinstead.
Freeoneormoreddnames:FREEDD(ddname)FREEDD(ddname1ddname2etc.)
Freeoneormoredatasets:FREEDSN(datasetname)FREEDSN(datasetname1datasetname2etc.)
Freeaprintfileddnameandchangethedestination:
FREEDD(ddname)DEST(newdest)
11.7FTPFTPisusedtotransferfilesfromoneusertoanother,usuallybetweendifferentcomputingsystems.
EstablishanFTPconnectionwithanothersystem:FTPip-address
7/31/2019 Fundamentals of TSO
70/84
MVS-35-TSO
7/31/2019 Fundamentals of TSO
71/84
FundamentalsofTSO
11.8HELPHELPisusedtodisplayvariousTSOhelptopics.ThisformofHELPdoesnotuseISPF.
Displaylistofavailablehelptopics:HELP
Displayaspecifichelptopic:HELPtopic
11.9IOFIOFisusedtomonitortheprogressofbatchjobsqueuedforexecution,executing,andcompleted.IOFcanalsobeusedtocancelactivejobsandtoreview,print,purge,orredirectoutputfromjobsthathavecompleted.IOFperformsthesamefunctionsastheWYLBURcommandsCANCEL,FETCH,LOCATE,PRINT,ROUTE,andPURGE.
Displaybatchjobandprintqueues:IOF
(IOFcanalsobeinvokedbychoosingoptionIfromtheISPFmainmenu.)
11.10ISPFISPFisusedtostarttheISPFshell,whichprovidesaseriesofmenustosimplifyusageofTSOandprovidesadditionalfunctionality,includingafull-screeneditor.WhenISPFstarts,itautomaticallydisplaystheprimarymenu;however,youcanincludeanoption
tocauseittostartwithadifferentmenu.Validoptionsarethosethatwouldbevalidontheprimarymenu.
StarttheISPFshell:ISPF[option]
11.11ISRDDNISRDDNisaTSOprocedurethatcanonlybeinvokedfromanISPFcommandline.ItprovidesanISPFscreenwhichdisplaysthecurrentlyallocatedddnamesanddatasets.
Otherfunctions(e.g.,editorbrowse)canbeinvokedfromthescreen.
Displayallocatedddnamesanddatasetnames:ISRDDN
(SeealsoLISTALC.)
MVS-36-TSO
7/31/2019 Fundamentals of TSO
72/84
7/31/2019 Fundamentals of TSO
73/84
FundamentalsofTSO
11.12LINKLINKinvokesthelinkageeditortocreateabinaryexecutableprogramfromtheobjectcodedatasets.
Linkseveralobjectcodefiles:LINK(objectcode1objectcode2etc.)
Linkanobjectcodefilealongwithanysubroutinelibraries:LINK(objectcode)LIB(maybe-imsl-library)
Linkanobjectcodefile,asubroutinelibrary,andputtheloadmoduleinaspecificloadmodulelibrary:
LINK(objectcode)LOAD(load-library-name)LIB(some-library)
??Oneormorenamesofobjectcodedatasetsformthefirstpositionalparameter.IfthefirstqualifierofanobjectcodedatasetisyourPREFIX(typicallyyouruserid)andthelastqualifierisOBJ,thefirstandlastqualifiersmaybeomit
ted.
??UseofIMSLorothersystemprovidedlibrariesrequirethefullyqualifieddatasetnamesofthelibrariesbeincludedintheLIBparameter.
??WithouttheLOADparameter,LINKgeneratesaloadmodulenamesimilartotheobjectcodedatasetname.It'srecommendedthatyouprovidealoadmodulename,preferablyonethatalreadyexists.
11.13LISTALCLISTALCdisplaysthecurrentlyallocatedddnamesanddatasets.
Displayallocatedddnamesanddatasetnames,exceptsystem-generateddatasetnames:LISTALC
Displayallallocatedddnamesanddatasetnames,includingsystemgenerateddatasetnames:LISTALCSYSNAMES
(SeealsoISRDDN.)
11.14LISTCATLISTCATdisplaysalistofcatalogedfilesforwhichthefirstqualifiermatchesyour
PREFIX(typicallyyouruserid).TheLEVELoperandisneededtodisplayadifferentlist.ISPFalsohasanoptiontodisplaythesimilarinformationinafull-screenformat.
Displaycatalogentriesbeginningwithyouruserid:LISTCAT
MVS-37-TSO
7/31/2019 Fundamentals of TSO
74/84
7/31/2019 Fundamentals of TSO
75/84
FundamentalsofTSO
DisplaycatalogentriesbeginningwithWYL.AB.CDE:LISTCATLEVEL(WYL.AB.CDE)
11.15LISTDSLISTDSdisplaysdatasetattributeinformation,suchasrecordformat,blocksize,ormembernames.ISPFhasseveralmoreconvenientmethodsforobtainingthesameinformation.
Displaydatasetattributes:LISTDSdatasetname
Displaymembernamesinapartitioneddataset:LISTDSdatasetnameMEMBERS
11.16LOADGOLOADGOisusedtoloadobjectcodeintomemory,link-editingitasit'sloaded,and
thenexecutingitwithoutcreatingabinaryexecutablefile(loadmodule).Alternately,oneoftheISPFpanelsprovidesamethodfordoingasimilarprocess.
Loadandexecuteseveralobjectcodefileswithruntimeparameters:LOADGO(objectcode1objectcode2etc.)'parameters'
Loadandexecuteobjectcodealongwithanysubroutinelibraries:LOADGO(objectcode)LIB(maybe-imsl-librarymaybe-calcomp)
??UseofIMSLandothersystemprovidedlibrariesrequirethefullyqualifieddatasetnamesofthelibrariesbeincludedintheLIBparameter.
11.17LOGOFFTheLOGOFFcommandisusedtoterminatetheTSOsession.YoumustexitISPFbeforeyoucanusetheLOGOFFcommand.
LogofffromthecurrentTSOsession:LOGOFF
11.18LOGONTheLOGONcommandisusedtoterminatethecurrentTSOsessionandbeginanother
one,typicallywithadifferentuserid.YoumustexitISPFbeforeyoucanusetheLOGONcommand.
Logofffromthecurrentsessionandlogontoanewsession:LOGON[userid]
MVS-38-TSO
7/31/2019 Fundamentals of TSO
76/84
7/31/2019 Fundamentals of TSO
77/84
FundamentalsofTSO
11.19PROFILEPROFILEisusedtoestablishvarioussettingsforyourTSOsessions.Inparticular,youcanchangeyourPREFIXsetting,whichhasaninitialvalueofyouruserideachtimeyoulogon.
ChangethePREFIXtoanothervalue:PROFILEPREFIX(ABCDE)
DisablethePREFIX;alldatasetnamesmustbefullyqualified:PROFILENOPREFIX
DisplaythecurrentPROFILEsettings:PROFILELIST
Turnmessageidentifierson/offfordiagnosticmessages:
PROFILEMSGID
PROFILENOMSGID
11.20RECEIVETheRECEIVEcommandisusedtoreceivefilessentfromanotheruserandrestorethemtodisk.TheTRANSMITcommandisusedtosendafiletoanotheruser.RECEIVEshouldbespecifiedwithoutanyoptions.
TheRECEIVEcommand(withnooptions)promptsyouforeachfiletobereceived.(Youhavenocontrolovertheorderinwhichthefilesarereceived.)Therearethreepossibleresponsestotheprompt:DELETE,todeletethecurrentfile;END,tote
rminatetheRECEIVEcommand);andRESTOREwithoptionalparameterstoreceivethefile.(RESTOREisthedefaultandmaybeomitted.)
Ifyoureceivethefilewithoutprovidinganewname,thefileisgiventhesamenameastheoriginalbutwiththefirstqualifierreplacedwithyouruserid.Tosavethefilewithadifferentname,useDSN(filename)asoneoftheoptionalparameters.
UsetheTSOHelpcommandforfurtherinformation:HELPRECEIVE.(OnanISPFcommandline,useTSOHELPRECEIVE.)
Alogfilenameduserid.LOG.MISCiswrittencontainingasummaryofthefilesreceivedortransmitted.Thespaceforthisfilecomesoutofyourdiskquota,soyoushouldperiodicallydeleteit.
MVS-39-TSO
7/31/2019 Fundamentals of TSO
78/84
FundamentalsofTSO
11.21RENAMERENAMEisusedtorenamedatasetsormembersofdatasets.ISPFalsohasseveralrenamefacilities.Ifadatasetisprotectedbyobsoletefeatures,suchastheNOPWREADsetting,theTSORENAMEcommandshouldbeused.
Renameadataset:RENAMEoldnamenewname
Renameamember:RENAMEdataset(oldmembername)dataset(newmembername)
11.22SENDSENDisusedtosendamessagetoanotheruserontheMVSsystem.Sendamessagetoseveraluserids:SEND'texttobesent'USER(userid1userid2etc.)
11.23SUBMIT
SUBMITisusedtosubmitbatchjobsforprocessing.ThiscommandisdiscussedintheBATCHJOBSUBMITTALsectionofthiswrite-up.
Submitabatchjob:
SUBMITdsname/*TSOcommand*/
SUBMIT(dsnamedsname...)/*TSOcommand*/
SUBMIT/*SPF/PDFeditorcommand*/
11.24TRANSMIT
TheTRANSMITcommandisusedtosendfilestoanotheruser.TheRECEIVEcommandisusedtoreceivefilessentfromanotheruserandrestorethemtodisk.(ASU'sVM/CMSsystemhasalocallydevelopedutility,MVSSEND,whichcantransmitafiletotheAcademicMVSsystem.ThesyntaxforMVSSENDissimilartotheSENDFILEcommand.DoNOTusetheSENDFILEcommand.)
Thefollowingcommandsillustratehowtotransmitanentirepartitioneddataset,asinglememberofapartitioneddataset,andasequentialdataset.(ThenodenameoftheacademicMVSsystemisACADMVS.)
TRANSMITnode.useridDSN(pds.data.set)/*entirePDS*/TRANSMITnode.useridDSN(pds.data.set(member))SEQ/*onemember*/TRANSMITnode.useridDSN(seq.data.set)SEQ/*sequential*/
MVS-40-TSO
7/31/2019 Fundamentals of TSO
79/84
FundamentalsofTSO
UsetheTSOHelpcommandforfurtherinformation:HELPTRANSMIT.(OnanISPFcommandline,useTSOHELPTRANSMIT.)
Alogfilenameduserid.LOG.MISCiswrittencontainingasummaryofthefilesreceivedortransmitted.Thespaceforthisfilecomesoutofyourdiskquota,soyoushouldperiodicallydeleteit.
11.25UNPRESSUNPRESSisusedtodecompressWYLBUReditformatdatasets.UNPRESShasonerequiredpositionalparameter(thenameofthedatasettobedecompressed)andanoptionalDSNAMEkeywordparameter(thenameoftheoutputdataset).Iftheoutputdatasetnameisomitted(recommended),theoriginaldatasetisreplacedwithadecompressed,variableformatdataset.
UsetheDSNAMEoptiononlyifyouwanttoretaintheoriginaldatasetorifyouwantthedecompresseddatasettobeinfixedformat.Inthissituation,theoutputd
atasetmustexistbeforeyouexecuteUNPRESS;i.e.,youneedtocreateanemptyoutputdataset(withanamedifferentthantheinputdataset)oftheappropriatesizeandformatbeforeexecutingUNPRESS.
UNPRESScanbeenteredonacommandline,butismostoftenusedonanISPF3.4datasetlistpanel.Onadatasetlistpanel,youtabtothelinecontainingthedatasetnameofinterestandtype%UNPRESStotheleftofthedatasetname.Thedatasetnameisassumedasthefirstpositionalparameter,i.e.,youdon'thaveto(and
mustnot)typetheinputdatasetname.
(UNPRESSisactuallyanexecwrittenintheREXXlanguage.Assuch,thecommandisusuallytypedas%UNPRESSforefficiencyreasons.)
DecompressaWYLBURdataset:
%UNPRESSinputdsn/*Decompressinplace*/
%UNPRESSinputdsnDSNAME(outputdsn)/*Decompressintoanother*/
12.MISCELLANEOUS12.1InteractiveProgramExecutionInteractionexecutionvariesbysoftwareproduct.Thedocumentationforeachsoftwareproductprovidesthenecessaryinformation.Ingeneral,softwareisaccessedviaISPFpanelsorsystemprovidedexecs.SomesoftwaremayrequireadditionalALLOCstatementsbeforebeingused,whileothersmayrequireuseoftheCALLstatement.Forexample,SASisinvokedbyasinglecommand,whichisanexecthatinternallyco
7/31/2019 Fundamentals of TSO
80/84
ntainsmanyALLOCstatementsandaCALLstatement.ItisrarelynecessarytoenteranyothercommandstobeginusingSAS.
MVS-41-TSO
7/31/2019 Fundamentals of TSO
81/84
FundamentalsofTSO
Forsomeprograms,suchasthosewritteninFORTRAN,itisnecessarytocompiletheprogram,(maybe)linkit,andthenexecuteit.Forexample,aFORTRANprogrammaybecompiledandlinkedfromISPFoption4andlaterexecutedviatheCALLstatement.Alternatively,youcanbypassISPFandthesystemexecsentirelybyenteringthevariousALLOCandCALLstatementsyourself,thoughyouwouldneedtorefertothereferencemanualstodeterminewhatstatementsareneeded.
Youcancreateexecstoautomaticallyexecutecertaincommands,buildaneditmacro,orexecuteoneofyourownprograms.Typically,theexecwouldcontaineditor,ISPF,orTSOcommandswithsomeadditionalcontrolstatements(e.g.,REXXcontrolstatements).
12.2TechnicalDetailsThelogonprocedureusedbymostpeopleisISPFPDFS,whichisamemberinthe
partitioneddataset'SYS1.PROCLIB'.ISPFPDFSdefinesnumerousddnames.Ifyouwanttoaddyourownlibrariestoanyofthepre-allocatedddnames,besuretoincludetheexistinglibrarieswhenreallocatingtheddnames.
TheddnamesSTEPLIBandISPLLIBdefineloadmodulelibrariesforbinaryexecutableprograms,butonlyISPLLIBmaybealteredduringaTSOsession.Forexample,ifyouputsoftwareonthesystemwhichrequiresaloadmodulelibrary,youcouldreallocatetheISPLLIBddname(whileISPFisnotactive)todefineadditionalruntimelibraries.
ThusyoucouldsubsequentlyinvokethesoftwarefromwithintheISPFenvironment.
Otherddnamesandtheirusesare:SYSPROCforCLISTandREXXexecs(interpretedprograms);SYSEXECforREXXexecsonly;ISPPLIBforpanels(menus);ISPMLIBformessages;ISPSLIBforskeletons(editortemplates);ISPTLIBfortables;andISPTABLforoutputtables.(TheISPxxxxddnamescanberedefinedbutmustbedonewhileISPFisnotactive.)
Usingtheseddnames,youcancreateyourownpanels,execs,editmacros(whichare
usuallyCLISTorREXXexecs),etc.YoucancustomizeyourTSOand/orISPFsessionsaccordingtoyourneeds.
Othermethodsexistsfordefiningddnameswhichprovidethesamefunctionasthosedescribedabove.Refertovendordocumentationforinformationonthisandothermethodsofdefiningrun-timelibraries.
7/31/2019 Fundamentals of TSO
82/84
12.3LocalHelpandSampleCodeInadditiontovendorprovidedonlinehelp,otherlocallydevelopedhelpfilesandcodesamplesareavailableforusewiththeMVSsystem.
MVS-42-TSO
7/31/2019 Fundamentals of TSO
83/84
FundamentalsofTSO
Thelocallydevelopedhelpfilesareavailableviaawebbrowser(suchasNetscapeorInternetExplorer).TheURLforthehelpfilesishttp://www.asu.edu/it/fyi/mvs/.
Codesamplesforcommondisk/tapeutilityprogramareavailableduringaTSOISPFeditingsession.Followthestepsoutlinedbelowtoaccessthecodesamples.
??Begineditingthefileintowhichthecodesampleistobeinserted.??TypetheeditingcommandMODELCLASSJCLontheeditorcommandlineandpressEnter.Thisidentifieswhichsetofsamplecodetouse.
??TypetheeditingcommandMODELontheeditorcommandline,andtypeanAorBinalinenumberfield(toindicatewherethesamplecodeistobeinserted)andpressEnter.
??SelectfromthedisplayedmenuwhetheryouwantDiskorTapesamples,andpressEnter.
??Selectfromthedisplayedmenuwhichsamplecodetouse,andpressEnter.
(Therearemorecodesamplesthancanbedisplayedonasinglemenu.PressPF7orPF8toseeothermenupages.)
ThesamplecodeincludescommentstoindicatewhatJCLmodificationsshouldbemadebeforethecodeissubmittedforexecution.
MVS-43-TSO
7/31/2019 Fundamentals of TSO
84/84
Top Related