Function: Функция: 
  Browse AWS tape - show tape map, directory of unloaded IEHMOVE and IEBCOPY data sets, content of individual members of those data sets as well as sequential data sets on the tape. awslist implemented as Windows console application and designed in old fashion VM/CMS FILELIST style :-) Просмотр моделируемой магнитной ленты формата AWS. Отображаются краткие сведения о файлах ленты ("справка"), оглавления наборов данных, выгруженных программами IEHMOVE и IEBCOPY, содержимое последовательных наборов данных и разделов выгруженных библиотек, список файлов, выгруженных командами TAPE и VMFPLC2 VM/CMS. awslist реализовано как консольное приложение Windows, а его внешний вид и функциональность подобны старомодному VM/CMS FILELIST :-)
 
Syntax:Формат: 
 
  AWSLIST [-batch] [-ebcdic codepage] [-ascii codepage] awstape
 
PrerequestedТребования: 
 
  • Open object REXX (OOREXX)
  • The Hessling Editor (THE), Windows version 3.3B3 includedThe Hessling Editor (THE), версия Windows 3.3B3 включена
 
InstallationУстановка 
  Special installaion procedure not required. However, windows console session used for awslist need to be customized. awslist provide browsing of tape data, so it is important to represent data correctly, including possible national characters. awslist delivered with shortcut (awslist.lnk) already customized for cyrillic languages. If you use different language, you need to change awslist propeties as follows:
  • specify the proper font which is represent national characters
  • specify correct EBCDIC and ASCII codepages (-e and -a options) to provide correct national characters representation. Please see this page and choose a proper codepage for your native language. Please use THE against any file with national characters to be sure that ASCII console codepage is correct.

Delivered shortcut defines font "Lucida Console" with 14px size, and do not specified EBCDIC and ASCII codepages (-e and -a options), therefore default codepages 20880 and 1251 are used.

Какая-либо специальная установка awslist не требуется, однако, может потребоваться настройка сессии консоли windows. Так как основной функцией awslist является просмотр данных, они должны корректно отображаться, включая национальные символы. awslist поставляется с ярлыком (awslist.lnk), который обеспечивает отображение символов кириллицы. Если для представления данных используется другой язык, необходимо изменить свойства ярлыка следующим образом:
  • указать подходящий шрифт для правильного представления национальных символов;
  • указать подходящие кодовые страницы EBCDIC и ASCII для правильного представления национальных символов. См. эту страницу для выбора подходящих кодовых страниц используемого языка. Используйте THE для редактирования произвольного файла с национальными символами, чтобы убедиться в правильности кодовой страницы ASCII.

Поставляемый ярлык определяет шрифт "Lucida Console" размером 14px и кодовые страницы 20880 (EBCDIC кириллица) и 1251 (Windows кириллица).

 
Usage:Применение 
  Let's consider awslist features on example. Enter awslist.lnk jessy.aws, where jessy.aws is AWS file kept on the same directory (path can be specified as required). You'll see progress indicator, because whole tape should be processed first, then the following screen appears: Рассмотрим использование awslist на примере конкретного файла jessy.aws. После выполнения awslist.lnk jessy.aws, где jessy.aws файл AWS, расположенный в тоже каталоге, что и awslist (может указываться путь, если это не так) происходит обработка всей эмулируемой ленты (индикатор продвижения показывет процент обработанных блоков) и, когда вся лента обработана, появляется следующий экран:
AWSLIST 1.0 JESSY.aws map SL,JGTAPE
 
File Blocks Name Recfm Lrecl Blksize Created Content
1 119 INSTALL F 00080 00080 13.05.1985 RDR
2 87 JESSY.INSTALL FB 00080 00800 13.05.1985 IEHMOVE
3 69 JESSY.LINK VS 03641 03645 00.01.2000 IEBCOPY
4 19 JESSY.PROC VS 00816 00820 00.01.2000 IEBCOPY
5 37 JESSY.ARX VS 00896 00900 00.01.2000 IEBCOPY
6 208 JESSY.HELP VS 00896 00900 00.01.2000 IEBCOPY
7 211 JESSY.HLINK.D5050 F 03584 03584 13.05.1985
8 102 JESSY.HLINK.D5061 F 07168 07168 13.05.1985
9 58 JESSY.HLINK.D5066 F 12928 12928 13.05.1985
10 199 JESSY.IALL FBA 00133 03990 00.01.2000 WTR
11 102 JESSY.ISYS FBA 00133 03990 00.01.2000 WTR
12 27 JESSY.IREST FBA 00133 03990 00.01.2000 WTR
13 41 JESSY.ISTUD FBA 00133 03990 00.01.2000 WTR
14 31 LIB4.TERMTEXT VS 03536 03540 00.01.2000 IEBCOPY
15 27 LIB4.TERMEDIT VS 07310 07314 00.01.2000 IEBCOPY
16 249 JESSY.INSTR VS 04096 04100 00.01.2000 IEBCOPY
17 69 JESSY.LINK.SVS VS 03641 03645 00.01.2000 IEBCOPY
18 95 WTR7934 VS 00416 00420 00.01.2000 IEBCOPY
19 6 JESSY.RDRZ VS 03641 03645 00.01.2000 IEBCOPY
F1=help F2=cmdline F3=quit F7=backward F8=forward F10=browse F12=cancel

Token shown on the upper right corner ("SL,JGTAPE" here) is tape label type and volume label in case of standard labelld tape (SL in term of OS/360-OS/370-z/OS), otherwise it if unlabelled (NL). Column "File" show file sequence number, it can be used in JCL to process particular data set (DSN=JESSY.LINKLIB,LABEL=(3,SL) for instance). Column "Blocks" show number of blocks in appropriate tape file, columns "Name", "RECFM", "LRECL", "BLKSIZE", "Created" shows data set name and it's attributes. Of course, name and most attributes shown for standard labelled tape only, however, procedure tried to calculate LRECL and RECFM for non-labelled tape too. Column "Content" indicate a special data set format. If it recognized, name of the processing program is shown. So, "RDR" means recognized job (JCL) stream, WTR means printable output, IEHMOVE - data set unloaded by IEHMOVE and so on.

You can scroll the list with F7/F8 and PgUp/PgDown, but also can unhide command line with F2 and then use any THE command - locate, find etc.

Move cursor to the first line (data set INSTALL) and press F10. Content of the sequetial data set INSTALL being displayed:

В верхнем правом углу отображается тип меток (SL, NL в терминах OS/360-OS/370-z/OS), и имя тома в случае стандартных меток (SL). Колонка "File" содержит порядковый номер файла ленты, он может использоваться в заданииs (JCL) для обработки определенного набора данных летны (например, DSN=JESSY.LINKLIB,LABEL=(3,SL)). В колонке "Blocks" отображается количество блоков файла, в колонках "Name", "RECFM", "LRECL", "BLKSIZE", "Created" имя набора данных и его атрибуты. Разумеется, имя набора данных как и большинство атрибутов отображается только для ленты со стандартными метками (SL), однако, awslist пытается определить формат и длину записи ("RECFM" и "LRECL") и для ленты без меток (NL). В колонке "Content" указывается, что обнаружен специальный формат набора данных, т.е. этот набор данных записан для обработки определенной программой. Так, "RDR" означает, что набор данных содержит поток заданий (JCL), WTR - что набор данных предназначен для вывода на печать, IEHMOVE - набор данных, выгруженный программой IEHMOVE и т.д.

Список можно листать с помощью F7/F8 и PgUp/PgDown, но также можно вызвать командную строку THE с помощью F2 и затем использовать любые команды THE - locate, find etc.

Переместите курсор к первой строке (набор данных INSTALL) и нажмите F10. Отобразится содержимое последовательного набора данных INSTALL

AWSLIST 1.0 INSTALL data SL,JGTAPE
//INSTALL JOB 'O-1-1',MSGLEVEL=(1,1)
//PRT EXEC PGM=IEBGENER
//SYSPRINT DD DUMMY
//SYSIN DD DUMMY
//SYSUT2 DD SYSOUT=A,DCB=(BLKSIZE=800,LRECL=80,RECFM=FB)
//SYSUT1 DD *
C O C T A B Д И C T P И Б У T И B H O Й Л E H T Ы
C И C T E M Ы J E S S Y
HOMEP ИMЯ ФAЙЛA TИП KOMMEHTAPИЙ
1 INSTALL GENER ЭTOT TEKCT
2 JESSY.INSTALL MOVE БИБЛИOTEKA ЗAДAHИЙ ДЛЯ УCTAHOBKИ
3 JESSY.LINK COPY БИБЛИOTEKA ЗAГPУЗOЧHЫX MOДУЛEЙ
(MVT MFT)
4 JESSY.PROC COPY ПPOЦEДУPЫ ДЛЯ ПOMEЩEHИЯ B
F1=help F2=cmdline F3=quit F7=backward F8=forward F12=cancel

Press F3 tо go back to the tape map, move cursor to the second line (data set JESSY.INSTALL) and press 10. Directory of this partitioned data set unloaded by IEHMOVE appears:

Нажмите F3 для возврата к оглавлению ленты, переместите курсор вниз (к набору данных JESSY.INSTALL) и нажмите F10. Будет отображено оглавление этого набора данных, выгруженного программой IEHMOVE:

AWSLIST 1.0 JESSY.INSTALL directory SL,JGTAPE
Member TTR
COPYPROC 000000
INSTALL 000302
MVT5050 000803
MVT5061 000406
MVT5066 00030D
PRTINSTR 000502
SERVLOC 000706
SVS5050 00020F
SVS5061 000704
SVS5066 000608
F1=help F2=cmdline F3=quit F7=backward F8=forward F10=browse F12=cancel

Move cursor to the member in the list and press F10 to see member content:

Переместите курсор к разделу библиотечного набора данных из списка и нажмите F10 для его просмотра:

AWSLIST 1.0 JESSY.INSTALL(COPYPROC) data SL,JGTAPE
//COPYPROC JOB 'O-1-1',JESSY,MSGLEVEL=(1,1),REGION=128K
//COPY EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=A
//SYSUT3 DD SPACE=(TRK,(20,20)),UNIT=SYSDA
//SYSUT4 DD SPACE=(TRK,(20,20)),UNIT=SYSDA
//JPROC DD DSN=JESSY.PROC,DISP=SHR
//PROC DD DSN=SYS1.PROCLIB,DISP=SHR
//SYSIN DD *
COPY INDD=((JPROC,R)),OUTDD=PROC
//
F1=help F2=cmdline F3=quit F7=backward F8=forward F12=cancel

The same features are available for the data set unloaded by IEBCOPY utility:

Такие же возможности доступны для наборов данных, выгруженных программой IEBCOPY:

AWSLIST 1.0 JESSY.LINK directory SL,JGTAPE
Member TTR
ARXMAIN 000604
IEFSD080 000B03
IEFVMA 000B12
IJSFVALL 000B22
IJSTXCMD 000C0C
IJSVTAB 000B1A
JESDEBHF 000A1D
F1=help F2=cmdline F3=quit F7=backward F8=forward F10=browse F12=cancel

Current version of awslist also recognized VM/CMS TAPE DUMP and VMFPLC2 formats and can display list of original VM/CMS files and their attribites. However, browse of original files not yet supported

Данная версия awslist также опознает формат VM/CMS TAPE DUMP и VMFPLC2 formats и отображает список оригинальых файлов VM/CMS с их атрибутами, но просмотр содержимого оригинального файла пока не поддерживается.

When browsed tape file has ASA print control character (i.e. RECFM is FA of FBA), these control charactes interpreted and removed, so rather than

Если просматриваемый последовательный набор данных содержит управляющие символы печати в коде ASA (т.е. RECFM FA или FBA), эти управляющие символы интерпретируются и удаляются, и вместо следующего

1




             БOЛOTOB A.C.,  EBФИMИУ B.A.,  ШИПOBAЛOB A.Д.
+            БOЛOTOB A.C.,  EBФИMИУ B.A.,  ШИПOBAЛOB A.Д.
+            БOЛOTOB A.C.,  EBФИMИУ B.A.,  ШИПOBAЛOB A.Д.










        $$$$$$$$    $$$$$      $$$$$      $$$$$    $$$    $$$
+       $$$$$$$$    $$$$$      $$$$$      $$$$$    $$$    $$$
+       $$$$$$$$    $$$$$      $$$$$      $$$$$    $$$    $$$
we can see better readable text: будет отображаться более читабельный текст:
AWSLIST 1.0 JESSY.IREST data SL,JGTAPE
БOЛOTOB A.C., EBФИMИУ B.A., ШИПOBAЛOB A.Д.
$$$$$$$$ $$$$$ $$$$$ $$$$$ $$$ $$$
$$$ $$$ $$$ $$$ $$$ $$$ $$$ $$$ $$$ $$$
$$$ $$$ $$$ $$$ $$$ $$$ $$$ $$$ $$$
$$$ $$$ $$$ $$$ $$$ $$$ $$$
$$$ $$$$$$$$$ $$$ $$$ $$$$$
$$$ $$$ $$$ $$$ $$$
F1=help F2=cmdline F3=quit F7=backward F8=forward F12=cancel
 
Batch modeПакетный режим 
  Batch mode (-batch option) awslist creates tape map and exits. In this mode THE do not used. В пакетном режиме (указано -batch) awslist записывает оглавление ленты и заканчивает работу. В этом режиме THE не используется.
 
NotesПримечания  
 
  • Procedure kept on the current directory all browsed files and directories as well as tape map.

    Процедура не удаляет файлы, появившиеся в результате просмотра данных ленты.

  • I suppose, this is close enough to analyze ancient SL tapes. However, I hope to add processing of another special format in future, like IEHDASDR/IDCDMPRS dump, DDR dump, finalize VM/CMS TAPE DUMP as well as VMFPLC2 processing etc etc.

    Полагаю, что в текущем состоянии возможностей awslist достаточно для удобного анализа образов антикварных лент времен ОС ЕС. Тем не менее, я предполагаю развивать awslist чтобы обрабатывать файлы, выгруженные IEHDASDR/IDCDMPRS, DDR etc etc.

  • Why filelist (fulltext) style? Because I said so :) I believe, form must match the content. Почему в стиле filelist? Потому, что я так захотел :) Я всегда считал, что форма должна соответстовать содержанию.
© 2022 Gregori Bliznets gregorytwin@gmail.com © 2022 Григорий Близнец gregorytwin@gmail.com