mashan nokia

7/15/2019 mashan nokia

http://slidepdf.com/reader/full/mashan-nokia 1/35

MASHAN User Manual

dn985368Issue 9-0 en

# Nokia CorporationNokia Proprietary and Confidential

1 (35)

2003330

Nokia BSC S10.5 ED, Vers. 2, ProductDocumentation



The information in this documentation is subject to change without notice and describes only theproduct defined in the introduction of this documentation. This documentation is intended for theuse of Nokia's customers only for the purposes of the agreement under which the documentationis submitted, and no part of it may be reproduced or transmitted in any form or means without theprior written permission of Nokia. The documentation has been prepared to be used byprofessional and properly trained personnel, and the customer assumes full responsibility whenusing it. Nokia welcomes customer comments as part of the process of continuous developmentand improvement of the documentation.

The information or statements given in this documentation concerning the suitability, capacity, or performance of the mentioned hardware or software products cannot be considered binding butshall be defined in the agreement made between Nokia and the customer. However, Nokia hasmade all reasonable efforts to ensure that the instructions contained in the documentation areadequate and free of material errors and omissions. Nokia will, if necessary, explain issueswhich may not be covered by the documentation.

Nokia's liability for any errors in the documentation is limited to the documentary correction of errors. NOKIA WILL NOT BE RESPONSIBLE IN ANY EVENT FOR ERRORS IN THISDOCUMENTATION OR FOR ANY DAMAGES, INCIDENTAL OR CONSEQUENTIAL(INCLUDING MONETARY LOSSES), that might arise from the use of this documentation or the

information in it.

This documentation and the product it describes are considered protected by copyrightaccording to the applicable laws.

NOKIA logo is a registered trademark of Nokia Corporation.

Other product names mentioned in this documentation may be trademarks of their respectivecompanies, and they are mentioned for identification purposes only.

Copyright © Nokia Corporation 2003. All rights reserved.

2 (35) # Nokia CorporationNokia Proprietary and Confidential


MASHAN User Manual



Contents

Contents 3

List of tables 4

List of figures 5

Summary of changes 7

1 Introduction 91.1 Introduction 9

2 Command Descriptions 112.1 Command Descriptions 11

3 Error Outputs 353.1 Error Outputs 35



3 (35)

Contents



List of tables



MASHAN User Manual



List of figures



5 (35)

List of figures





MASHAN User Manual



Summary of changes

Summary of changes

Changes between document issues are cumulative. Therefore, the latest document

issue contains all changes made to previous issues.

Changes made between issues 9 and 8

I INITIALIZE DISK OR ROOT DIRECTORY

F5 format support has been added to floppy disk.


References to floppy disks have been replaced with removable disks.

References to Winchester disks have been replaced with hard disks.

I INITIALIZE DISK OR ROOT DIRECTORY

For removable disk media, FAT 12, FAT16 or FAT32 file

system possibilities have been added. In the case of either

FAT12, FAT16 or FAT32, the creation of partition table is

optional.


M COPY FILE TO FILE

Command MO has been added. A new parameter for

command MO has been added in the command description of

command M. The syntax has been updated.

X DIRECTORY/FILES ON TAPE/PROGRAM OR FILE

VERSION/CHECKSUM X

The description of command X has been explained in moredetail.

The layout of the examples has been improved.



7 (35)

Summary of changes





MASHAN User Manual



1 Introduction

1.1 Introduction

The Mass Memory Handling Program Block (MASHAN) is one feasible

extension in the service terminal software of the DX 200 system. It is taken intouse with a command of the service terminal software.

With the MASHAN program block it is possible to use disk drives and reel tapes

of the DX 200 system (= two hard disk drives, two removable disk drives, eight

MTUs (Magnetic Tape Units) and four CTUs (Cartridge Tape Units)).

The commands are directed to different mass memory devices by setting one or

more of the following parameters as device parameters:

W0 hard disk 0

W1 hard disk 1

F0 removable disk 0

F1 removable disk 1

M0 - M7 magnetic tape 0 - 7

C0 - C3 cartridge tape 0 - 3

The actual name of the directory can contain 1 to 11 characters, and the extensionis always DIR. The actual name of the file can contain a maximum of 11

characters and the extension four. The version number can be between 1 - 254 (1

- 0FEH). Zero is the default version, the only exceptions being the D and N

commands, where the version zero refers to all versions. If no version number is

given, it is equivalent to having given zero as the version number.



9 (35)

Introduction



The path can be given either from the root of the disk (starts with the "/"

character) or from the default sub-directory (starts with the name of the sub-

directory). For example, if the default sub-directory of W0 is PACKET01, the

paths W0-/PACKET01/FILES/CODE/ and WO-FILES/CODE/ refer to the same

sub-directory.

In the D, M, NV and X commands, wild card characters (*) can be used in the file

name and extension, and in the D, M and X commands, wild card characters are

possible also in the version number. For example, MAS*.* refers to all names

beginning with MAS, and *.IMG refers to all files with the extension IMG. If the

file name and extension are not given in these commands, it is equivalent to *.*:0,

i.e. the default versions of all files (in the X command also the directories). When

deleting files, the MASHAN program block asks the user for confirmation only if

reference is made to all files in a directory.

If an MTU is used, it is presumed that the tape format to be read complies withthe ANSI standard modified for DX 200 use when the main type is as follows:

. Multifile/Single Volume Configuration

. Variable Length Record.

The tape type must be fixed as BACKUP if the tape files are copied (M

command), output (T command), or listed (X command), or if the tape is

preformatted (I command).

The inquiry and setting of the tape type (Y command) as well as the absolutereading (TA command) can be performed on all tape types. Absolute reading

means that the user is able to output the tape from a specific block (on the basis of

the ordinal number) irrespective of the file structure on the tape.



MASHAN User Manual



2 Command Descriptions

2.1 Command Descriptions

The command menu:

Menu of the command group:

? . .. .. M EN U / H EL P

A . . .. . A B SO L UT E S C SI C O N TR O LL E R C O MM A ND

B . .. .. B AD / G OO D B LO CK

C . .. .. C RE AT E F IL E / D IR EC T OR Y

D . .. .. D EL ET E F IL E / D IR EC T OR Y / F IL E S ET

E . .. .. E MP TY F I LE

H . . .. . S E T D I S K H E AD S T O T R A N S FE R P O SI T IO N

I . . .. . I N IT I AL I ZE D I SK O R D I R EC T OR Y / F O RM A T T A P E

M . .. .. C OP Y F IL E T O F I L E

N . .. .. C HA NG E N AM E / C HA NG E D EF A UL T V ER SI ON

P . .. .. P AC K D IS KQ . . .. . D E VI C E I N FO R MA T IO N

R . .. .. R EA D F RO M F IL E / R EA D B YT ES / A BS OL UT E R EA D

S . . .. . S E T A T TR I BU T ES

T . .. .. T YP E F IL E / A BS OL UT E

V . .. .. P AT CH F I LE / D I RE CT O RY / A BS OL UT E

W . .. .. W RI TE B L OC KS / B YT ES / L O AD M O DU LE / M ML / A BS OL UT E W RI TE

X . .. .. D IR EC TO R Y / F IL ES O N T AP E / P RO GR AM O R F IL E V ER SI ON / C HE CK SU M

Y . .. .. S ET / S HO W T A PE T YP E

Z . .. .. R ET UR N T O M AI N L EV EL

A: ABSOLUTE SCSI CONTROLLER COMMAND

Function

Command A is used to give the absolute SCSI-bus command. The I/O device

(W0, W1, F0, C0...) is the first parameter, the following bytes (6/10/12) form the

SCSI bus standard command block. If necessary, the memory address, byte count

and DMA mode is the last parameter (1 = read, 2 = write).

Additional determiner S can be used to decrease the number of redundant

execution printouts apart from error outputs.



11 (35)

Command Descriptions



Syntax

A(S):I/O_device,SCSI_block(:address,byte_count,mode);CR

Examples

Example 1.

Format hard disk 1.

MAS> A:W1,4,0,0,0,5,7;

EXECUTED

B: BAD / GOOD BLOCK

Function

Command B is used to set the track of a hard disk to bad, so that it is no longer

used in the storing of data. Command BG is used to bring a track that has been

set as bad back into use.

Command BN is used when giving bad blocks to ANSI-type disks. The bad

blocks are given by separate prompts, and once a block has been set as bad, the

setting can be deleted only by formatting.

Command BL is used to output the bad blocks of ANSI-type disks: either the P

list (PRIMARY), which is set by the manufacturer, or the G list (GROWN),

which is set by the user. The G list can be emptied when formatting, if desired.

The following alternatives are available for the output of bad blocks: the number

of bad blocks only (DEFAULT), logical block number (L), bytes from index (B)

(CYL-HEAD-BYTES) or physical sector (S) (CYL-HEAD-SECTOR).

Syntax

B(G):disk,block_no;CR

BN:disk;CR

BL(P/G):disk(,L/,B/,S);CR

Examples

Example 2.

Set as bad the track on disk 0 on which block 1234 is situated.

MAS> B:W0,1234;



MASHAN User Manual



EXECUTED

Example 3.

Bring into use the track on disk 1 on which block 3333 is situated.

MAS> BG:W1,3333;

EXECUTED

C: CREATE FILE / DIRECTORY

Function

Command C is used to create a new disk file. The size of the file is given in

blocks (one block is 512 bytes). The initials of the executor of the command can be given as the initialisation parameter. Additional determiner D is used to direct

the operation to both disk units (e.g. W0 and W1). The command outputs the

version number of the created file. Initials and version numbers have no effect if

destination is removable disk.

Command CD is used correspondingly to create a new subdirectory. The number

of the files refers to the number of the file/directory labels which can be

accomodated by the directory. If the value given is not divisible by ten, it is

brought up to the next value divisible by ten. The version limit refers to the

largest number of versions which can occur simultaneously for a certain file

name.

Syntax

C:(D)disk-(path)file_name(.ext),size(,creator);CR

CD:(D)disk-(path)directory_name(.DIR),file_count

(,version_limit)(,initializer);CR

Examples

Example 4.

AK creates a file named ABCDEF.ABC of 10 blocks in the default subdirectory

of hard disk 1.

MAS> C:W1-ABCDEF.ABC,10,AK;

EXECUTED



13 (35)




Example 5.

AK creates a file named ABCDEF.ABC of 10 blocks in subdirectory /TESTS/

MML of hard disk 1. The TESTS subdirectory is situated in the root of disk W1.

MAS> C:W1-/TESTS/MML/ABCDEF.ABC,10,AK;

EXECUTED

Example 6.

PK creates a file named ABCDEF.ABC of 25 blocks in subdirectory /PACKET1/

MML of hard disk 0. PACKET1 is the default subdirectory of disk W0.

MAS> C:W0-MML/ABCDEF.ABC,25,PK;

EXECUTED

Example 7.

AK creates a subdirectory named TMP.DIR, which can accomodate at least 0FFH

labels, in subdirectory /PACKET1/FILES of hard disk 1. PACKET1 is the default

subdirectory of disk W1. Two is given as the version limit.

MAS> CD:W1-FILES/TMP.DIR,FF,2,AK;

EXECUTED

D: DELETE FILE / DIRECTORY / FILE SET

Function

Command D is used to delete a disk file. Command DD is correspondingly used

to delete a subdirectory. Additional determiner D is used to direct the operation to

both disk units (e.g. W0 and W1). Command DK is used to delete directories

containing files and subdirectories. Command DS is used to remove the last file

group on a cartridge tape.

If the version is zero (default value) or a wild card character (*), all file versionsare deleted, otherwise only the given version. The default version alone cannot be

deleted if the file has several versions. Wild card characters can be used in the file

name, extension and version. If the name and extension are not given, all the files

in the directory are deleted. The MASHAN program block asks the user for

confirmation if reference is made to all files.



MASHAN User Manual



A directory can be deleted with the DD command only if it does not comprise

directory or file labels. The DK command deletes all empty subdirectories from

the disk or the subdirectories that are emptied during the execution of the

command. The directories are deleted from below the given directory, including

the given source directory. For example, a whole package (ZMDK:W0-/580/) or

the desired files (ZMDK:W0-/580/*.OLD) can be deleted from the disk with one

command. All non-default versions can also be deleted from the package at one

time (purge) (ZMDK:W1-/580/*:FF). However, it must be noted that if the DK

command is to be used to delete files, the empty subdirectories are also deleted.

The command also removes the protections from the files before deleting them.

The DS command deletes the last file group from the cartridge tape by searching

for the save set mark (set mark) from the end of the tape and by replacing it with

the filemark. The command can also be used to delete an empty file group (save

set mark alone).

Syntax

D:(D)disk-(path)(file_name(.ext)(:version));CR

DD:(D)disk-(path)subdirectory(.DIR);CR

DK:disk-(path)(file_name(.ext)(:version));CR

DS:tape_unit;CR

Examples

Example 8.

Delete version 10 of file ABCDEF.ABC from the default subdirectory of harddisk 1.

MAS> D:W1-ABCDEF.ABC:10;

EXECUTED

Example 9.

Delete all versions of file ABCDEF.ABC from the root of hard disk 1.

MAS> D:W1-/ABCDEF.ABC;

EXECUTED

Example 10.

Delete directory MMDIRE.DIR from the default subdirectory of hard disk 1.

MAS> DD:W1-MMDIRE.DIR;



15 (35)




EXECUTED

Example 11.

Delete directory MMDIRE.DIR and all its files and subdirectories from thedefault subdirectory of hard disk 0.

MAS> DK:W0-MMDIRE/;

EXECUTED

E: EMPTY FILE

Function

Command E is used to empty a disk file. Additional determiner D is used to

direct the operation to both disk units (e.g. W0 and W1).

Syntax

E:(D)disk-(path)file_name(.ext)(:version);CR

Examples

Example 12.

Empty version 4 of file ABCDEF.ABC in the default subdirectory of hard disk 1.

MAS> E:W1-ABCDEF.ABC:4;

EXECUTED

H: SET DISK HEADS TO TRANSFER POSITION

Function

Command H is used to transfer the read heads of the hard disks into a safe

position during transfer.

Syntax

H:disk;CR

Examples

Example 13.

Set the read heads for transfer.



MASHAN User Manual



MAS> H:W0;

EXECUTED

I: INITIALIZE DISK OR DIRECTORY / FORMAT TAPE

Function

Command I is used to format a disk and to initialize the DX 200 file structure in

it. In the case of a hard disk, the condition of the disk is also checked and spare

tracks are set for bad tracks. The number of the files refers to the number of the

file/directory labels which fit into the root directory. If the value given is not

divisible by ten, it is brought up to the next value divisible by ten. The version

limit refers to the largest number of concurrent versions that a given file name can

have in the root directory. The initials of the initializer can be given as the

parameter. It is possible to give 4 or 5 (which corresponds to the directorystructure of the DX 200 system release concerned).

For Magneto optical disk FAT16 or FAT32 file system can be chosen. For floppy

disk FAT12 or F5 can be chosen. In the case of either FAT16 or FAT32, the

creation of partition table is optional. For file_system parameter, F5 stands for F5,

F12 for F12, F16 for FAT16, and F32 for FAT32.

If the hard disk is of the type ANSI, the MASHAN program block asks the user

whether the list of bad blocks given by the user (GROWN, list G) is to be

removed. The bad tracks set by the manufacturer (PRIMARY, list P) cannot be

deleted. Bad blocks are added with the command BN .

If a hard disk is being initialized, the user can set the number of the disk-drive

cylinders as well as the number of the read/write heads. If the user does not give

new values, the default values apply. The default values are found in the

packaging parameters of the Disk Program Block (EDISKD). The above

parameters are not given for ANSI type disks.

Syntax

I(D):disk-file_name(.DIR),file_count

(,version_limit)(,initializer)(,format)));CR

Examples

Example 14.

OV initializes hard disk 1 named WINSU.DIR. The root directory of the disk can

accomodate at least 200H file labels. Three is given as the version limit.

MAS> I:W1-WINSU.DIR,200,3,OV;



17 (35)




W A R N I NG ! ! !

T HI S C OM MA ND D ES TR OY S A LL T H E D AT A O N T HE D IS K

D O Y O U R EA LL Y W A N T T O D O T HA T? (Y /N ) Y

D I S K P A R A M ET E R S :

D E F AU L T C Y LI N DE R C O UN T = 0 1 36G IV E N EW C Y LI ND ER C OU NT , C R = D EF AU LT :

D EF AU L T H EA D C OU NT = 0 6

G IV E N EW H E AD C OU NT , C R = D EF AU LT :

INITIALIZING

0 2 H B A D T R AC K S F O U N D

Example 15.

Initialize a removable disk F0 and name it FLOPPY.DIR. The file system to be

created is FAT16 and partition table is created.

MAS> I:F0-FLOPPY.DIR,F16,T;

W A R N I NG ! ! !

T HI S C OM MA ND D ES TR OY S A LL T H E D AT A O N T HE D IS K

D O Y O U R EA LL Y W A N T T O D O T HA T? (Y /N ) Y

I N I T I AL I Z I N G: F 0FLOPPY.DIR:00

D I S K I N I T I AL I Z E D S U C C E S F U L L Y : F 0FLOPPY.DIR:00

Example 16.

On disk W0, initialize a new root directory WINSU0.DIR, which can accomodate

at least 200H file and directory labels.

MAS> ID:W0-WINSU0.DIR,200;

W A R N I NG ! ! !

T HI S C O MM AN D D E S TR OY S A L L T H E D A TA O N T H E D I SK

D O Y OU R EA LL Y W A NT D O T HA T? (Y /N ) Y

INITIALIZING

EXECUTED

Example 17.

Preformat tape TAPE00.

MAS> I:M0-TAPE00;

W A R N I NG ! ! !

T HI S C O MM AN D D E S TR OY S A L L T H E D A TA O N T H E T A PE

D O Y OU R EA LL Y W A NT D O T HA T? (Y /N ) Y

INITIALIZING

EXECUTED

M: COPY FILE TO FILE



MASHAN User Manual



Function

Command M is used to copy disk and tape files. The copying can be performed

from one device to another but not from tape unit to tape unit. Additional

determiner S is used to minimise the number of execution printouts resulting from

copying. In this way, the copying of large file amounts can be accelerated. Only

the error outputs, changes of directories and the end report will be output.

Additional determiner D is used to direct the operation to both disk units (e.g.

DW0). Wild card characters (*) can be used in the source file names. If the

version number of the source file is not given, the default version is copied,

otherwise the given version. If the object file name is not given, the file is copied

under the same name as the source file. A new file under the desired name (new

version) is always created in the object directory, and it becomes the default

version.

If all the versions of the file are copied, the old versions of these files are deletedfrom the object directory first. The version which is the default version in the

source directory then becomes the default version also in the object directory. The

version numbers, however, do not always remain the same.

The command can be used to copy large files by distributing them in smaller parts

among several removable disks and then by returning the parts as one file onto

the hard disk. When a file distributed among several removable disks is returned

as one file, a file of the original size is first created in the object directory and it is

filled with zeros. In addition, a work file is created and a bit map is stored in it for

the duration of copying. After each disk is copied, the object file is marked as bad

(the bad attribute is set), and the bit map is marked so that it shows which blocksare copied into the object file. When all the file parts are copied, the work file is

deleted and the bad marking of the object file is removed. The removable disks

(file parts) can be copied at random. When copying large files, the removable

disks must be empty (in other words, they must not contain any files or

subdirectories, apart from the files created by the system). In addition, when

copying large files from removable disks to the hard disk, only the parts of the

same file version can be copied at the same time.

If the MC command is used for copying, the new version does not become the

default version if there already is a file under the same name in the object

directory.

When copying files within the same directory, the version restriction must be

taken into account. If there already are three versions of a given file in the

directory and one of these versions is copied back into the same directory, a new

version is first created of this file, and the EDISKD program block automatically

deletes the oldest non-default version. If the deleted old version happens to be the

source file (version), the copying obviously cannot be executed.



19 (35)




Command MD can be used to copy directories with their files or without them.

Additional determiner R is used to change the name of the source directory in the

object directory. It cannot be used if the default directory or the whole disk is

copied. For example, the whole package can be copied to its own backup

directory with the additional determiner R. The name of the backup directory

(new name) is given in the object directory name field.

By default, the files are saved at the end of the tape (after the files already on

tape). Additional determiner B is used to force the copying to the beginning of the

tape. In this case, the files already on tape are lost. Additional determiner I is used

to start the copying from the current position of the tape (MTU only). When

copying to tape with additional determiner I, the files after the writing position are

deleted. Additional determiner D is used to copy the subdirectories, too.

The files and directories copied to cartridge tape at different times can be

separated from each other to their own file groups. By default, each copying tocartridge started with the M command creates a new file group on the cartridge.

However, the tape must be checked in case a file group by the given name already

exists. If the file group name is not given, the default name (MAS_yymmdd) is

used. When files are copied to cartridge, they can be directed to the last file group

by giving LAST as the group parameter.

At the beginning of copying to tape and every time the directory is changed, a

'directory file' is written on tape, indicating the directory to which the files that

follow belong (the disk directory from which they were copied). However, it must

be noted that if the path given in the copying command is relative (begins from

the default directory), a relative directory path is saved also on tape. The copyingcan be started from the desired file by giving the 'number of the first file'

parameter. The parameter is not significant if the files are copied with their

directories.

The version number and attribute of the source file and the times of creating and

editing are also stored on the cartridge tape. Due to this procedure, the desired

versions (number or default version) can be copied from the cartridge tape

selectively. This cannot be done with magnetic tape.

The files and directories of no more than one file group can be copied at one time

from cartridge tape to disk. If files are to be copied from tape to disk, the directory

(cf. disk) from which files fulfilling the given selection criteria are searched must

always be given. If determiner D is used, the subdirectories and the files in them

are also copied.

Command MO can be used to copy files contained in the file group from tape to

disk in the unit where the command was given. The source device must be a

cartridge tape unit. When run in the minidebugger mode, the operation of the

command is restricted because the system assumes that the command is entered in

the OMU. That is why only OMU's files are output in minidebugger mode.



MASHAN User Manual



Syntax

M(C)(S):disk-(path)(source_file_name(.ext)(:version)),(D)disk-

(path)(object_file_name(.ext))(,first_file_no);CR

MD(S)(R):disk-(path)(source_file_name(.ext)(:version)),disk-(path);CR

M(D)(S)(I)(O):tape_unit-(path)(source_file_name(.ext):(version)),disk-

(path)(object_file_name(.ext))(,group);CR

M(D)(S)(B/I):disk-(path)(source_file_name(.ext)(:version)),tape_unit-

(object_file_name(.ext))(,first_file_no(,group));CR

Examples

Example 18.

Copy version 2 of file ABCDEF.ABC in the default subdirectory of hard disk 0 to

the default subdirectory of removable disk 0 as file FEDCBA.CBA.

MAS> M:W0-ABCDEF.ABC:2,F0-FEDCBA.CBA; ABCDEF.ABC:

0 0 10 H B L OC K S C O PI E D

Example 19.

Copy all default versions with IMG extensions in the default subdirectory of hard

disk 0 to the default subdirectory of hard disk 1.

MAS> M:W0-*.IMG,W1;

DMXX.IMG: 0010H BLOCKS COPIED

WDIX.IMG: 0026H BLOCKS COPIED

Example 20.

Copy all files and directories on magnetic tape 0 to hard disk 0.

MAS> MD:M0-/,W0-/;

C CC CC CC C. CC C: 0 0 01 0H B LO CK S 0 00 01 FC 5H B YT ES I N F IL E

A AA AA AA A. AA A: 0 0 00 2H B LO CK S 0 00 00 39 BH B YT ES I N F IL E

B BB BB BB B. BB B: 0 0 02 1H B LO CK S 0 00 04 0F 8H B YT ES I N F IL E

Example 21.

Copy file AAAA.BB on hard disk 0 to the beginning of magnetic tape 0.

MAS> MB:W0-AAAA.BB,M0;

C OP YI NG : W 0- AA AA .B B T O M 0 -A AA A .B B 0 01 0H B LO CK S C OP IE D



21 (35)




N: CHANGE NAME / CHANGE DEFAULT VERSION

Function

Command N is used to change the name of a disk file. The initials of thecommand executor can be given in the variable parameter. Version 0 changes the

names of all versions. The default version alone cannot be renamed. With

Command NV , the default version of the file can be changed. Wild card

characters (*) can be used in the file name and extension of the NV command.

Syntax

N:disk-(path)old_name(.ext)(:version),

(path)new_name(.ext)(,variable);CR

NV:disk-(path)file_name(.ext),version;CR

Examples

Example 22.

Rename all versions of file OLD.NAME on hard disk 1 WINSU.NAME.

MAS> N:W1-OLD.NAME,WINSU.NAME;

EXECUTED

Example 23.

Set version 2 of file OLD.NAME on hard disk 1 as the default version.

MAS> NV:W1-OLD.NAME,2;

EXECUTED

P: PACK DISK

Function

Command P is used to pack hard disks; i.e. the file structure of the disk is

compressed. The command is used in the restructuring of a fragmented disk (inother words, a disk on which numerous file deletions have been performed).

Syntax

P:disk;CR



MASHAN User Manual



Examples

Example 24.

Pack disk 0.

MAS> P:W0;

EXECUTED

Q: DEVICE INFORMATION

Function

Command Q is used to output information about the manufacturer of the I/O

device, the product, and the product version.

Syntax

Q : I / O d e v i c e; C R

Examples

Example 25.

Output information about disk 0.

MAS> Q:W0;

VENDORIDENTIFICATION:FUJITSU

PRODUCTIDENTIFICATION:M2954S-512

PRODUCTREVISION:0132

R: READ FROM FILE / READ BYTES / ABSOLUTE READ

Function

Command R is used to read data in blocks from a disk file into memory.

Command RB is used to read data from a disk file to memory in bytes. If a

delimiter has been given, data is read until the delimiter byte is reached. If adelimiter has not been given, data is read according to the byte count.

The default value of block and byte count parameters is 0FFFFH. The default

value of the initial block parameter is 1 and the default value of the initial byte

parameter is 0. Command RA is used to read data into memory from an absolute

disk address. Additional determiner D is used to direct the operation to both disk

units.



23 (35)




Syntax

R:(D)disk-(path)file_name(.ext)(:version),memory_address

(,block_count(,initial_block));CR

RB:(D)disk-(path)file_name(.ext)(:version),memory_address(,byte_count(,initial_byte(,delimiter)));CR

RA:disk,memory_address,block_count,<hard_initial_block

/floppy_cylinder,floppy_side,floppy_sector>;CR

Examples

Example 26.

Three blocks = 1536 bytes are read from the default version of file ABCDEF.

ABC in the root of hard disk 1 to address G40.0, starting from block number 1.

MAS> R:W1-/ABCDEF.ABC:0,G40.0,3;

0 0 03 H B L OC K S R E AD

Example 27.

Version 3 of file ABCDEF.ABC in directory /P1/LFILES/TMP of removable disk

0 is read to address G40.0. Subdirectory P1 is in the root of the disk.

MAS> R:F0-/P1/LFILES/TMP/ABCDEF.ABC:3,G40.0;

0 0 03 H B L OC K S R E AD

Example 28.

12 bytes are read from the default version of file ABCDEF.ABC in directory

TMP.DIR of hard disk 1 to address G40.0, starting from byte 200H of the file.

Subdirectory TMP is in the default subdirectory of disk W1.

MAS> RB:W1-TMP/ABCDEF.ABC,G40.0,12,200;

0 0 12 H B Y TE S R E AD

Example 29.

Attempt to read file ABCDEF.ABC in the default subdirectory of disk 0. The file

has not been created. Since a dual command was used, an attempt is made to read

the same file from disk 1, where it is found.

MAS> R:DF0-ABCDEF.ABC,G40.0;

R E A D I NG : F 0 - A B CD E F . A BC

/ * ** N O :S U CH F I L E



MASHAN User Manual



R E A D I NG : F 1 - A B CD E F . A BC 0 0 0 1 H B L O C K S R E A D

S: SET ATTRIBUTES

Function

Command S is used to set or remove file attributes for hard disks. The possible

attributes are write protection (W), lockout (L), bad file (B), archive file (A), and

the FTAM file (F). The attributes are set by writing the identifier of the attribute

plus 1 (e.g. L1 = set lockout) and removed by writing the identifier plus 0 (e.g.

W0 = remove write protection). The attributes can be given in any order.

Additional determiner D is used to direct the operation to both disk units (e.g. W0

and W1).

The write protection (Write protected) prevents all writing to the file. A bad file

(Bad) contains unreadable or unwriteable blocks. A locked file (Locked) can only be handled by the person who set the locking. A file is always marked as an

archive file (Archive) when something is being written to it. The archive

attributes are removed in backup copying. The FTAM attribute is used in files

which are in the FTAM format.

Syntax

S:(D)disk-(path)file_name(.ext)(:version),

attr(,attr*N);CR

Examples

Example 30.

Set write protection for the default version of file CCCC.C on disk 0. The file is

in directory /SUB/DIRE/CTORY. Directory SUB is in the root of the disk.

MAS> S:W0-/SUB/DIRE/CTORY/CCCC.C,W1;

EXECUTED

Example 31.

Set file ABCDEF.ABC on hard disk 0 to lockout and, at the same time, removethe bad file and write protection attributes. The file is in the default subdirectory

of the disk.

MAS> S:W0-ABCDEF.ABC,W0,B0,L1;

EXECUTED



25 (35)




Example 32.

Set the default versions of file ABCDEF.ABC on disks 0 and 1 to lockout. The

file is first searched on disk 0. In this example, the file is not on disk 1.

MAS> S:DW0-ABCDEF.ABC,L1;

S E T T I NG A T T R I BU T E S : W 0 - A B CD E F . A BC

S E T T I NG A T T R I BU T E S : W 1 - A B CD E F . A BC

/ ** * N O S UC H F IL E

T: TYPE FILE / ABSOLUTE

Function

Command T is used to display the contents of a file. Command TA displays the

contents of a disk or a tape. The record-width option is used to set the output to adesired width. The default value of the record number parameter is 1 and the

width option 16. With the default values, the output occurs in blocks of 512 bytes.

If the width option is in use, the output is started from the address record number

x width + 200H + infomodule length. The record number is then displayed at the

beginning of the line. If the width is 200H, the start is from address 0, and the

FID block is visible (FID=file identifier). The output is terminated with the Ctrl-C

keys. Ctrl-S is used to interrupt the output, and it can be restarted with Ctrl-Q.

Additional determiner E is used to display the contents of an EBCDIC-coded tape

in ASCII form.

Syntax

T:disk-(path)file_name(.ext)(:version)

(,record_number(,record_width));CR

TA:disk,<hard_initial_block/floppy_initial_cylinder,

floppy_initial_side,floppy_initial_sector>;CR

T(E):tape-(path)file_name(.ext)(:version)(,group);CR

TA(E):tape(,block_length(,initial_block,(block_count)));CR

Examples

Example 33.

Display version 2 of file TEST.DATA on hard disk 1 starting from block 1. Thefile is in the default subdirectory of the disk.

MAS> T:W1-TEST.DATA:2;

B L OC K N O : 0 0 0 1

0 00 0: 0 0 00 0 0 0 0 00 0 0 0 0 00 0 0 0 0 00 0 0 0 0 00 0 0 0 0 . .. .. .. .. ... .. ..

0 00 0: 4 1 42 4 3 4 4 45 4 6 4 7 48 4 9 4 A 4B 4 C 4 D 4E 4 F 5 0 A BC DE FG HI JKL MN OP

0020: 5 1 5 2 QR



MASHAN User Manual



E ND O F D AT A F OU N D

Example 34.

Display the contents of disk 0 starting from block 10.

MAS> TA:F0,10;

B L OC K S N O : 0 0 00 0 01 0

0 00 0: 0 0 00 0 0 0 0 00 0 0 0 0 00 0 0 0 0 00 0 0 0 0 00 0 0 0 0 . .. .. .. ... .. ... .

0 01 0: 4 1 42 4 3 4 4 45 4 6 4 7 48 4 9 4 A 4B 4 C 4 D 4E 4 F 5 0 A BC DE FG HIJ KL MNO P

.

.

.

Example 35.

Display the default version of file SECTORS.TES in the root of the disk in 2-byte

width. The output starts from byte 2 because the given record number is 1. The

record number is at the beginning of the line.

MAS> T:F0-/SECTORS.TES,1,2;

00000001: E8 E2 ..

00000002: 3B CB ;.

.

.

.

Example 36.

Display the contents of tape 0 starting from block 0; the displayed block length is

20H.

MAS> TA:M0,20,0;

B L O C K : 0 0 0 0 H

0000: 56 4 F 4C 3 1 41 5 3 44 2 0 20 2 0 20 2 0 20 2 0 20 2 0 VOL 1A SD

0010: 20 2 0 2 0 2 9 2 0 2 0 20 20 2 0 2 0 2 0 2 0 2 0 20 2 0 2 0

B L O C K : 0 0 0 1 H

.

.

.



27 (35)




Example 37.

Display the hard disk file ABC.LAA starting from address 0 by giving 200H as

the width option. The record number is not significant if the width option is

200H. In this case, note that instead of the record number being output at the beginning of the line, the data address is output.

MAS> T:W0-ABC.LAA,0,200

00000000: 20 20 20 20 46 49 44 3A 20 20 20 20 20 20 20 20 FID:

0 00 00 01 0: 20 2 0 2 0 20 2 0 2 0 2 0 2 0 2 0 2 0 2 0 2 0 2 0 2 0 2 0 2 0

.

.

.

V: PATCH FILE / DIRECTORY / ABSOLUTE

Function

Command V modifies file data, command VD modifies directory data, and

command VA modifies block data. Command VL is used to modify the data on

the load module and to count its check sum. The modified block is written back

to disk only if the user accepts this when prompted by the system. Note that the

VD command is only an adapted case of command VA.

A maximum of 256 bytes are visible from a block (512 bytes). The initial byte

determiner is used to specify the number of the byte on which the cursor is placed

once the block has been read from the disk. The default value of the initial block

is 1, while that of the initial byte and initial label is 0.

If the data has been changed, the MASHAN program block asks the user whether

the block is to be written on disk when a block is modified or a command is

ended. If an error occurs when writing or reading the block, the MASHAN

informs the user about it with an error message at the bottom of the screen. If the

error is serious, that is, if it prevents the user from continuing the modifications, a

return is made to the prompt.

In the V commands, the cursor can move in two fields: in the hexadecimal and in

the ASCII fields. Both fields display the same uninterrupted area of the block; the

maximum length of the area is 256 bytes. The fields differ in the following ways:

FUNCTION HEXA DE CIM AL A SC II

____________________________________________________________

cursor moves in half b ytes in by tes

horizontally

data input only hexa de cim al any

characters characters



MASHAN User Manual



The V commands recognise the following keyboard code sequences:

CODE FUNCTION

Ctrl-C(03H) end of editing

Ctrl-D(04H) directory patching help

Ctrl-E(05H) editor help

Ctrl-G(07H) cursor to desired block; MASHAN forms a block number as

illustrated in the figure below. The V command changes

simultaneously into absolute form to prevent unnecessary

errors.

Ctrl-N(0EH) next block

Ctrl-P(10H) previous block

TAB(09H) ASCII/hexadecimal input

arrow up line up (= 16 bytes left)

arrow down line down (= 16 bytes right)

arrow left byte left

arrow right byte right

HOME cursor to 1st byte of block

Syntax

V:disk-(path)file_name(.ext)(:version)

(,initial_block(,initial_byte));CR

VL:disk-(path)file_name(.ext)(:version)

(,initial_block(,initial_byte));CR

VD:disk(,initial_label);CR

VA:disk,<hard_initial_block/floppy_initial_cylinder,

floppy_initial_side,floppy_initial_sector>;CR

Examples

Example 38.

Modify block 50H of hard disk 0.

MAS> VA:W0,50



29 (35)




BLOCK NO: 5 0 FROM : W0

0 0 0 1 0 2 0 3 0 4 0 5 0 6 0 7 0 8 0 9 0 A 0 B 0 C 0 D 0 E 0 F 0 12 34 56 78 9A BC DE F

0 00 0: X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X . .. .. .. .. .. .. .. .

0 01 0: X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X . .. .. .. .. .. .. .. .0 02 0: X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X . .. .. .. .. .. .. .. .

.

.

.

0 0F 0: X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X . .. .. .. .. .. .. .. .

Example 39.

Modify the directory of hard disk 1 from label 5 onwards. The directory block is

faulty, which is shown as a blinking FAIL text at the bottom of the screen. If the

block is now written onto the disk, the MASHAN corrects the check sum.

MAS> VD:W1,5

BLOCK NO: 0 023 FROM: W 1- DIR EC TO RY .DIR

0 0 0 1 0 2 0 3 0 4 0 5 0 6 0 7 0 8 0 9 0 A 0 B 0 C 0 D 0 E 0 F 0 12 34 56 78 9A BC DE F




.

.

.


C HE CK SU M; C A L CU L AT ED : X X XX , I N B L OC K: X X X X F AI L

Example 40.

Modify file ABCDEF.ABC of hard disk 1 starting from byte 10H of block 5H.

MAS> V:W1-ABCDEF.ABC,5,10

BLOCK NO: 0 005 FROM: W 1- ABC DE F .ABC

0 0 0 1 0 2 0 3 0 4 0 5 0 6 0 7 0 8 0 9 0 A 0 B 0 C 0 D 0 E 0 F 0 12 34 56 78 9A BC DE F


0 01 0: X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X . .. .. .. .. .. .. .. .0 02 0: X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X . .. .. .. .. .. .. .. .

.

.

.


W: WRITE BLOCKS / BYTES / LOAD MODULE / MML / ABSOLUTE WRITE



MASHAN User Manual



Function

Command W is used to write data in blocks to disk files. Command WB is used

to write data in bytes to disk files. If a delimiter has been given, data is written

until the delimiter byte is reached. If a delimiter has not been given, data is

written according to the byte count. The default value of the block and byte count

parameters is 0FFFFH. The default value of the initial block parameter is 1 while

the default value of the initial byte parameter is 0. Command WP writes program

files to disk. If a file of the same name is already on the disk, a new version is

created, otherwise a new default version is created. Data written with the WP

command must have a PID (PID=program identifier). Command WM functions

like the WP command but is intended for the writing of MML programs.

Commands WP and WM always create a new version of the file if a default

version already exists. Command WA writes data from memory to an absolute

disk address. The default value of the initial block parameter is 1, and that of the

initial byte parameter is 0. Additional determiner D is used to direct the operationto both disk drives. If the files on the disks are of different sizes, data is written to

them according to the size of the smaller file.

Syntax

W:(D)disk-(path)file_name(.ext)(:version),memory_address

(,block_count(,initial_block));CR

WB:(D)disk-(path)file_name(.ext)(:version),memory_address

(,byte_count(,initial_byte(,delimiter)));CR

WP:(D)disk-(path)file_name(.ext),memory_address(,writer);CR

WM:(D)disk-(path)file_name(.ext),memory_address(,writer);CR

WA:disk,memory_address,block_count,<hard_initial_block

/floppy_cylinder,floppy_side,floppy_sector>;CR

Examples

Example 41.

Write version 1 of file ABCDEF.ABC in the root of hard disk 1 full of data

starting from memory address G40.0.

MAS> W:W1-/ABCDEF.ABC:1,G40.0;

0 0 1 0 H B L O C K S W R I T T EN

E ND O F F IL E F OU ND

Example 42.

Write 30H bytes of data to version 6 of file ABCD.ABC from memory address

G40.0 or until delimiter 0DH is reached. The file ABCD.ABC is located in

subdirectory SUB2.DIR of the default subdirectory on hard disk 0. Start writing

from byte 200H of the file.



31 (35)




MAS> WB:W0-SUB2/ABCD.ABC:6,G40.0,30,200,D;

0 0 21 H B Y TE S W R IT T EN

Example 43.

Write program file WDIX.IMG to disk 0. The initial module of the program

named WDI must begin from memory address G40.0.

MAS> WP:F0-/WDIX.IMG,G40.0;


Example 44.

Starting from block 1234H, write 10H blocks of data from memory addressG40.0 to hard disk 0.

MAS> WA:W0,G40.0,10,1234;


Example 45.

Write data to files ABCDEF.ABC in the default subdirectories on the removable

disks starting from memory address G40.0.

MAS> W:DF0-ABCDEF.ABC,G40.0;

W R IT I NG : F 0 -A B C DE F .A B C x x x x H B L O CK S W R IT T EN

W R IT I NG : F 1 -A B C DE F .A B C x x x x H B L O CK S W R IT T EN

X: DIRECTORY / FILES ON TAPE / PROGRAM OR FILE VERSION /

CHECKSUM

Function

Command X is used to output the disk directory or the directory data of the

desired files. If a magnetic tape unit is set as the device, the output includes: the

name of the tape, the directory or the names of the files, their creation dates andsizes, and the system in which the tape was created. A cartridge tape unit is used

to output the names of the file groups or their contents. Command XP is used to

output the PIDs of the desired files. Command XF outputs the FIDs of the

desired files (FID=file identifier). Ctrl-C ends the output. Ctrl-S is used to

interrupt the output and Ctrl-Q to restart it. Command XV is used to check the

correctness of the checksum of the files (load modules) on the disk. If the

checksum is incorrect, the system outputs the text CHECKSUM FAILED. If the

checksum for the file is different from the one stored on disk but the file is of the



MASHAN User Manual



type (defined in the file's status bits) for which no checksum is updated, the

correctness of the file cannot be verified. In such cases like the text CHECKSUM

VERIFICATION NOT POSSIBLE is output. Command XE is used to output

from the disk the PIDs of service terminal extensions and a short description of

the intended use of the extensions.

Syntax

X(P/F/V/E):disk(-file_name(.ext)(:version));CR

X:tape(,group);CR

Examples

Example 46.

Output the root directory of hard disk 1.

MAS> X:W1-/;

VOLUME DX .DIR

I NI TI AL IZ ED B Y X Y 8 9- 0 1- 01 L AS T W R IT E 8 9- 01 -0 2

D I RE C TO R Y O F /


NUM NAME EXT VER SIZE FREE CREATED LAST MOD INI ATTR LOCKED B Y

Y Y - M M - DD Y Y - M M - DD

0 00 1 D IS K . DA TA :0 1 0 00 00 02 1 0 00 00 01 F 8 9- 01 -0 1 8 9- 01 -0 1 F C D W

0 00 1 D IS K . TE ST :0 1 0 00 00 02 1 0 00 00 00 0 8 9- 01 -0 1 8 9- 01 -0 1 F C D W

0 00 1 S E CT OR S . MA P : 0 1 0 0 0 00 06 5 0 0 00 0 00 D 8 9 -0 1- 01 8 9- 01 -0 1 F C D W

0 00 1 S E CT OR S . BA K : 0 1 0 0 0 00 05 8 0 0 00 0 05 8 8 9 -0 1- 01 8 9- 01 -0 1 F C D W

0 00 1 5 10 . di r : 01 00 00 00 1A 00 00 00 00 92 -0 3- 03 92 -0 3- 03 FC DW

TOTAL 0 00 0011E ( INCLUDING FIDS )

LISTED LABELS 00000005

0 00 23 11 9H B LO CK S U SE D O F T OT AL 0 0 05 6F 5 2H B L OC KS ( 4 0 % U SE D )

Example 47.

Output the PIDs of files beginning with MAS of the subdirectory BLCODE.DIR

in the default directory of hard disk 1.

MAS> XP:W1-BLCODE/MAS*;

VOLUME DX .DIR


D I RE C TO R Y O F /


NAME EXT VER CHECKSUM I D S TR IN G ( D = DEFAULT VERSION )

M AS HA NG X . IM G :0 5 D : 8 5E A4 6B D: 1 .7 0- 0 92 /0 4/ 22 D XS EN VG X. PA C 5. 2- 0



33 (35)




Example 48.

Output the name of the tape and the data on files on tape in tape unit 0.

MAS> X:M0;

N AM E O F T AP E = M TX LA B

NAME DATE SIZ E SYSTEM

BLCODE/

MASHANGX .IMG 9 2- 120 00 8C DX

TAPEDRGX .IMG 9 2- 120 00 27 DX

.

.

.

Y: SET / SHOW TAPE TYPE

Function

Command Y is used to set and read the tape type used by the preferred magnetic

tape unit or cartridge tape unit. In the change command, the type is given as an

absolute value used by the MTU program block.

In the device information command, the tape type in use will be displayed. If the

type is unknown, question marks will be displayed.

Syntax

Y:tape(,type);CR

Examples

Example 49.

Set the MTU 1 to use the type of charging tape that complies with the DX 200

system.

MAS> Y:M1,0

EXECUTED



MASHAN User Manual



3 Error Outputs

3.1 Error Outputs

If an error occurs in the execution of a command, the MASHAN program sets the

error status concerned in the variable D-STAT of the Command LanguageUtilities and Console Interface (CLUCIF), and outputs an error message on the

terminal. If the error code is missing from the program block's own list, only the

number of the error code is output.

Error Outputs

mashan nokia

Documents

Transcript of mashan nokia