home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Beijing Paradise BBS Backup
/
PARADISE.ISO
/
software
/
BBSDOORW
/
RATB100.ZIP
/
RATB_100.ZIP
/
RATB.DOC
< prev
next >
Wrap
Text File
|
1993-04-01
|
44KB
|
1,281 lines
┌──────────────────────────────────────────────────────────────┐
│ │
│ ▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀ │
│ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀ ▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀ │
│ ▀▀▀▀ ▀▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀ ▀▀▀▀ ▀▀ ▀▀▀▀ ▀▀▀▀ │
│ ▀▀▀▀ ▀▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ │
│ ▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀ ▀▀▀▀▀▀▀▀ │
│ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ │
│ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ │
│ ▀▀▀▀▀ ▀▀▀▀▀ ▀▀▀▀▀ ▀▀▀▀▀ ▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀ │
│ ▀▀▀▀▀ ▀▀▀▀▀ ▀▀▀▀▀ ▀▀▀▀▀ ▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀ │
│ │
│ Remote Access Time Bank - v1.00 │
│ Copyright (c) 1991-93 by Ivan F. Martinez │
│ │
└──────────────────────────────────────────────────────────────┘
INDICE
──────────────────────────────────────────────────────────────────────
Créditos e Agradecimentos . . . . . . . . . . . . . . . . . . . . 3
Reconhecimentos . . . . . . . . . . . . . . . . . . . . . . . . . 3
Características do Programa . . . . . . . . . . . . . . . . . . . 4
Descriçäo dos Arquivos que Compöem o Sistema . . . . . . . . . . 7
RATB.EXE . . . . . . . . . . . . . . . . . . . . . . . 7
RATBCFG.EXE . . . . . . . . . . . . . . . . . . . . . . 8
RATB.RAL . . . . . . . . . . . . . . . . . . . . . . . 10
RATBEDIT.EXE . . . . . . . . . . . . . . . . . . . . . 10
RATBCFG.COR . . . . . . . . . . . . . . . . . . . . . . 12
RATB.BLK . . . . . . . . . . . . . . . . . . . . . . . 12
Arquivos para Avisos . . . . . . . . . . . . . . . . . . . . . . 13
Instalaçäo . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Instalaçäo do RATB pela primeira vez no RA. . . . . . . 14
Instalaçäo do RATB pela primeira vez sobre o PC-Board . 15
UPGRADE de versöes anteriores a 0.80 . . . . . . . . . 16
Personalizando seu Menu . . . . . . . . . . . . . . . . . . . . . 17
Arquivos de Linguagem . . . . . . . . . . . . . . . . . . . . . . 19
Consideraçöes Finais . . . . . . . . . . . . . . . . . . . . . . 20
CREDITOS E AGRADECIMENTOS
──────────────────────────────────────────────────────────────────────
Documentaçäo: Roberto Narciso e Luciano Zoppe
RATB 1.00 Beta Team
Araken Salamene 4:801/31
Eldon Alencar 4:809/3
Flavio Lucarelli 4:801/30
Luciano Zoppe 4:801/7
Martin Gut 4:801/4
Roberto Narciso 4:801/11
Ruben Pinto 4:801/9
Stenio Pita 4:809/1
Agradecimentos a :
Luciano Zoppe - O primeiro a registrar o RATB
Flavio Lucarelli - O primeiro a registrar o RATB fora de Säo Paulo
Andrew Milner - Pelo Remote Access, US$50 bem aplicados...
RECONHECIMENTOS
──────────────────────────────────────────────────────────────────────
Remote Access Andrew Milner and Continental Software
PC-Board Clark Development Co.
ARJ Robert Jung
X00 Raymond L. Gwinn
BNU David Nugent & Unique Comp. Pty Ltd.
3
CARACTERISTICAS DO PROGRAMA
──────────────────────────────────────────────────────────────────────
O RATB é um programa externo (door) para RA e PC-BOARD, que permite a
cada usuário a guarda, para posterior retirada ou troca, de seu tempo,
de seus Kbytes e, quando rodando sobre o RA permite também de créditos
para NETMAIL, como numa conta bancária.
O RATB exige o PC-Board 14.5, ou o Remote Access 2.0 e näo funcionará
com versöes anteriores.
CARACTERISTICAS:
(Os itens que apresentarem {+} só estäo disponíveis na versäo regis-
trada, as informaçöes de como registrar estäo no REGISTER.FRM)
- Verificaçäo de Inatividade (Time-Out) do Usuário:
O programa verifica o tempo de inatividade do usuário, desconectan-
do-o caso seu tempo de inatividade tenha ultrapassado o limite de-
terminado pelo SysOp.
- Verificaçäo de Tempo Mínimo de Uso do BBS para a Entrada no RATB:
O programa conta o tempo usado desde o início da conexäo até o mo-
mento em que é carregado, se este tempo for menor que o determinado,
o programa retorna para o BBS e mostra o arquivo BBSFIRST.A?? ou o
texto (prompt) 68 do arquivo de linguagem (veja Linguagem).
- Verificaçäo de Tempo Restante para a Entrada no RATB:
O programa verifica se o tempo restante do usuário é igual ou infe-
rior ao determinado na configuraçäo, caso isto seja verdade retorna
para o BBS mostrando o arquivo TBINSUF.A?? ou o texto 11 do arquivo
de linguagem.
- Verificaçäo de Tempo Restante Mínimo:
O programa impede que os usuários depositem todo o seu tempo, fican-
do com o tempo restante no BBS insuficiente para desconectarem, por
exemplo. O mesmo valor definido configuraçäo como tempo mínimo para
entrada no RATB é utilizado como tempo restante mínimo.
- Funciona com Ansi/Avatar Ativo ou Näo.
- Aceita Configuraçäo de Cores:
No modulo de configuraçäo existe a opçäo de se configurar todas as
cores do que é mostrados na tela do usuário. As cores do programa de
configuraçäo poderäo ser configuradas no arquivo RATBCFG.COR
- Aceita Teclas-Chaves (Hotkeys):
O RATB funciona com teclas-chaves, isto é o usuário näo precisa te-
clar [Enter] após cada comando. As teclas podem ser definidas em ca-
da arquivo de linguagem.
- O SysOp Pode Alterar qualquer Conta:
É feita a verificaçäo do nível do usuário, quando o mesmo entra no
RATB, se o nível for maior ou igual ao SYSOP SECURITY LEVEL ele terá
acesso à opçäo de cancelamento e alteraçäo do saldo das contas.
4
CARACTERISTICAS DO PROGRAMA
──────────────────────────────────────────────────────────────────────
- O SysOp Pode Movimentar sua Conta sem Limites:
Se a opçäo 'SysOp Free Limits' estiver habilitada na configuraçäo, o
SysOp poderá fazer qualquer movimentaçäo sem que os limites diários
sejam verificados. No entanto os limites máximos da conta säo obede-
cidos.
- Pode-se Esconder a Conta de Certos Usuários na Listagem das Contas:
O usuário que tiver nível maior ou igual ao do SYSOP poderá ao ALTE-
RAR uma conta definir se ela é escondida, ou seja somente os SYSOPs
poderäo listá-la.
- Ordena (SORT) as Contas:
As contas podem ser ordenadas em ordem crescente ou decrescente, em
ordem de Nome, Tempo, Kbytes ou Créditos.
- Permite Transferência de Créditos, Tempo e Kbytes entre os Usuários:
O valor máximo permitido para cada transferência é configurável, po-
dendo receber o valor '0' que desativará as transferências.
- Permite Troca de Kbytes por Tempo e vice-versa:
O Valor de cada Kbyte em Minutos e de cada Minuto em Kbytes é confi-
gurável, se este valor for '0' esta funçäo estará desativada.
- Suporte para Múltiplas Linhas (Multi-Node):
Faz LOCK dos arquivos, isto evita que duas cópias do RATB tentem es-
crever ao mesmo tempo no arquivo de dados o que danificaria o arqui-
vo. Por este motivo näo é possível efetuar transferências para um
usuário, se este estiver utilizando o RATB em outra linha.
- Opçäo para Personalizaçäo do Menu:
O RATB possui um menu padräo, mas este pode ser substituído por uma
tela (ASC, ANSI ou AVATAR) criada pelo SysOp. Para isto o RATB conta
com vários códigos de controle que säo substituídos pelo respectivo
texto na hora de ser mostrado ao usuário (Os códigos seräo descritos
adiante).
- Dois Tipos de Menu, o Normal e um Expert:
No caso do usuário escolher o menu EXPERT será mostrado um menu re-
duzido. Isto evita perda de tempo com o desenho da tela.
- Permite Configurar um Título no lugar do 'RA TIME-BANK'. {+}
- Suporte para Várias Línguas:
O RATB possui arquivos de linguagens (que podem ser editados pelo
SysOp), com todos os textos mostrados aos usuários estäo nestes ar-
quivos, que possuem a extensäo .RAL.
- Presente de Aniversário Configurável por Nível:
(Para até 10 níveis diferentes)
Na data de aniversário o usuário poderá receber Tempo, Kbytes ou
Créditos no valor configurável pelo SysOp.
- Suporte para uma Configuraçäo para cada Linha e/ou Nível de Acesso:
Poderäo ser configurados limites diferentes para cada linha do BBS
e/ou para cada nível de acesso. Para cada configuraçäo será criado
um arquivo diferente.
5
CARACTERISTICAS DO PROGRAMA
──────────────────────────────────────────────────────────────────────
- Utilitário para Editar as Contas sem Entrar no RATB:
Através do utilitário RATBEDIT é possível alterar, consultar, orde-
nar as contas sem a necessidade de entrar no RATB. (Veja Descriçäo
dos Arquivos do Sistema)
- Opçäo para Definir um Nível Mínimo para Entrar no RATB:
Caso o usuário näo tenha o nível mínimo, quando entrar no RATB será
mostrado o arquivo TBLEVEL.A?? ou o texto 36 do arquivo de lingua-
gem.
- Listagem do Movimento das Contas nos Ultimos Dias.
- Suporte a Black List no RATB:
Se o nome do usuário estiver no arquivo RATB.BLK entäo ele näo terá
acesso ao RATB e será mostrado o arquivo TBBLACK.A?? ou o texto 39
do arquivo de linguagem.
- Desconexäo no próprio RATB:
É mostrado o arquivo GOODBYE.A??
- Opçäo para o Usuário Depositar Tudo que Resta.
- CHAT interno.
- Verifica o Horário do Próximo Evento:
O RATB vefica o horário do próximo evento, näo deixando o usuário
retirar ou comprar tempo, caso este acréscimo ultrapasse o horário
do evento.
- Permite a Utilizaçäo dos Códigos de Controle:
(no RA)
No menu e em todos os arquivos textos mostrados pelo RATB, podem ser
usados os códigos de controle ^F e ^K do RA.
- Opçäo de Gerar os LOGs em um único Diretório:
O diretório deverá estar na variável 'LOGPATH' definida na
Environment. (Ex: SET LOGPATH=C:\RA\)
- Suporte as Variáveis de Environment do PCBoard:
PCBNODE - indica o node utilizado.
PCBDIR - indica o diretório atual de configuraçäo.
PCBDAT - indica o nome do arquivo de configuraçäo.
- Permite a Utilizaçäo das Variáveis @COMMAND@ e Atributos @Xnn:
(no PCBOARD)
No menu e em todos os arquivos textos mostrados pelo RATB, podem ser
usados as variáveis @COMMAND@ e os atributos @Xnn, do PCBoard.
6
DESCRICAO DOS ARQUIVOS QUE COMPOEM O SISTEMA
──────────────────────────────────────────────────────────────────────
RATB.EXE
É o programa principal do RATB, que deve ser chamado pelo BBS.
Parâmetros na linha de comando do RATB.EXE, para executar diretamente
algumas opçöes: {+}
DEP_TIME - Deposita Tempo
DEP_KB - Deposita Kbytes
DEP_CRED - Deposita Créditos
DEP_ALL_TIME - Deposita Todo o Tempo
DEP_ALL_KB - Deposita Todos os Kbytes
DEP_ALL_CRED - Deposita Todos os Créditos
WITHD_TIME - Retira Tempo
WITHD_KB - Retira Kbytes
WITHD_CRED - Retira Créditos
WITHD_ALL_TIME - Retira Todo o Tempo
WITHD_ALL_KB - Retira Todos os Kbytes
WITHD_ALL_CRED - Retira Todos os Créditos
QUIT - Näo entra no MENU e retorna ao BBS
BYE - Desconecta após Executar os Comandos
';' - É interpretado como [Enter].
Se o RATB receber algum outro parâmetro, que näo sejam os listados
acima, o RATB assumirá este comando como se ele fosse digitado pelo
usuário.
Por Exemplo:
RATB 1;100
O RATB entenderá que o usuário digitou:
'1' [Enter] '100'
Dentro do RATB, você achará um linha de estado, muito semelhante a do
Remote Access, teclando F9 você tem uma lista das teclas disponíveis,
algumas delas säo:
ALT-C Entra em Chat com um Usuário, desativado quando em modo
local.
ALT-J Faz um Shell para o DOS, tecle 'Exit' para voltar.
As opçöes do Menu, dizem respeito a operaçöes de movimentaçäo das con-
tas näo necessitando de maiores explicaçöes. A opçäo de Listar as Con-
tas (List Accounts no Arquivo de Linguagem original), lista todos os
usuários näo escondidos (Para o SysOp ela também mostra os escondi-
dos). Se algum dos usuários listados estiver usando o RATB de outra
linha, ele terá sua data de última movimentaçäo como 'NOW' (no .RAL
Original). A opçäo de Listar os Movimentos (List Movements) mostra os
últimos movimentos realizados pelo usuário na conta.
Há ainda três opçöes no Menu, disponíveis somente na versäo registra-
da, que säo para uso do SysOp, Alterar uma conta (Change Accounts),
que possibilita a alteraçäo de qualquer conta, desde que o usuário näo
esteja conectado no momento, a opçäo de apagar uma conta (Delete Ac-
counts), e a opçäo de ordenar as contas (Sort Accounts). {+}
7
DESCRICAO DOS ARQUIVOS QUE COMPOEM O SISTEMA
──────────────────────────────────────────────────────────────────────
RATBCFG.EXE
É o programa de configuraçäo do RATB.
Maximum time - Saldo máximo de Tempo que uma conta pode
ter.
Maximum Kb - Saldo máximo de Kbytes que uma conta pode
ter.
Maximum Credit - Saldo máximo de Créditos que uma conta pode
ter.
Max. Daily Time Deposit - Valor máximo de depósito de Tempo que pode
ser efetuado por dia.
Max. Daily Kb Deposit - Valor máximo de depósito de Kbytes que pode
ser efetuado por dia.
Max. Daily Cred. Deposit - Valor máximo de depósito de créditos que
pode ser efetuado por dia. (Se o valor des-
te campo for '0' o banco de créditos estará
desativado).
Max. Daily Time WithDraw - Valor máximo de retirada de tempo que pode
ser efetuado por dia.
Max. Daily Kb WithDraw - Valor máximo de retirada de Kbytes que pode
ser efetuado por dia.
Max. Daily Cred.Withdraw - Valor máximo de retirada de créditos que
pode ser efetuado por dia.
Max. Daily Time Transfer - Valor máximo de tempo que pode ser transfe-
rido entre os usuários por dia. (Se o valor
deste campo for '0' esta opçäo estará desa-
tivada).
Max. Daily Cred. Transf. - Valor máximo de créditos que podem ser
transferido para outros usuários. (Se o va-
lor deste campo for '0' esta opçäo estará
desativada).
Max. Daily Kb Purchase - Indica o limite de Kbytes que podem ser
comprados por dia.
Purchase Value of Kb - Indica quantos Kbytes podem ser comprados
com 1 minuto de tempo. (Se o valor deste
campo for '0' esta opçäo estará desativa-
da).
Max. Daily time Purchase - Indica o limite de tempo que pode ser com-
prado por dia.
8
DESCRICAO DOS ARQUIVOS QUE COMPOEM O SISTEMA
──────────────────────────────────────────────────────────────────────
Purchase Cost of minute - Indica quantos Minutos podem ser comprados
com 1 Kbyte. (Se o valor deste campo for
'0' esta opçäo estará desativada).
BirthDay Time - Indica o número de minutos que é creditado
na conta do usuário se ele entrar no RATB
no dia do seu aniversário.
BirthDay Kb - Indica o número de Kbytes que é creditado
na conta do usuário se ele entrar no RATB
no dia do seu aniversário.
Time Out Limit - Indica o tempo (em segundos) em que o RATB
desconectará o usuário caso nenhuma tecla
seja pressionada.
SysOp Security Level - Nível de segurança do SysOp. Indica o nível
mínimo para ter acesso a funçöes de SysOp.
SysOp Free - Indica se o SysOp tem livre acesso a movi-
mentaçöes sem verificaçäo dos limites diá-
rios. Os limites das contas säo sempre ve-
rificados.
Minimum time remaining - Tempo mínimo restante ao usuário para que
ele possa acessar o RATB.
Minimum used to enter - Tempo mínimo de uso da BBS para poder en-
trar no RATB.
Path to Time Bank file - Nome do arquivo de dados do RATB (com o
PATH completo).
Title Color - Indica a cor do título.
Values Color - Indica a cor dos valores mostrados.
Normal Color - Indica a cor utilizada no restante da tela.
Select Color - Indica a cor do texto de seleçäo.
- Os códigos de cor devem ser (cor do texto)/(cor de fundo):
0 - Black 8 - DarkGray
1 - Blue 9 - LightBlue
2 - Green 10 - LightGreen
3 - Cyan 11 - LightCyan
4 - Red 12 - LightRed
5 - Magenta 13 - LightMagenta
6 - Brown 14 - Yellow
7 - LightGray 15 - White
- Somando 16 ao código da cor de fundo, será ativado o modo piscante.
9
DESCRICAO DOS ARQUIVOS QUE COMPOEM O SISTEMA
──────────────────────────────────────────────────────────────────────
- Para criar configuraçöes para outra linha ou nível de segurança, te-
cle F-1 e forneça o número da linha e/ou o número do nível. Note que
se for criado uma configuraçäo com número de nível para uma linha
onde näo existam outros arquivos de configuraçäo, os demais níveis
que acessarem esta linha continuaräo a ter a configuraçäo Default.
- O arquivo com o número de nível vale somente para aquele nível e näo
para os níveis superiores a ele, se existir uma configuraçäo para o
nível 200 o nível 300 näo será afetado por ela.
- A configuraçäo do nível é prioritária sobre a configuraçäo do node,
por exemplo se um usuário nível 50 puder retirar 100 Kbytes por dia
estiver no node 2 onde esta configurado para só se retirar 20 Kbytes
ele poderá retirar os 100 Kbytes normalmente.
- O presente de aniversário (Kbytes, Tempo e Créditos) será creditado
aos usuário que tiverem nível maior ou igual a qualquer uma das li-
nhas da configuraçäo.
RATB.RAL
É o arquivo de linguagem padräo do RATB, ela näo pode ser editada e
deve estar no mesmo diretório em que o RATB estiver. (Veja Linguagem)
RATBEDIT.EXE
É o Editor de Contas, também realiza a manutençäo dos arquivos de da-
dos.
Passando-se um parâmetro inválido, o RATBEDIT mostrará a lista dos pa-
râmetros válidos.
Parâmetros de linha de comando (modo manutençäo):
-AL Verifica os limites da conta. Verifica se existe algum
usuário que tenha conta com valor superior ao limite corri-
gindo-a.
-CU Converte nomes para Maiúsculas.
-CL Converte nomes para minúsculas.
-DM[dias] Apaga as contas dos usuários que näo entraram no RATB nos
últimos 60 dias ou no número de dias especificado.
-DI Apaga a conta dos usuários que näo existem mais no cadastro
do BBS.
-KL[dias] Apaga informaçöes (Dados sobre Movimentaçöes, e tranferên-
cias) com mais de 7 dias ou o número especificado.
-P Retira do arquivo de contas os registros apagados.
10
DESCRICAO DOS ARQUIVOS QUE COMPOEM O SISTEMA
──────────────────────────────────────────────────────────────────────
-PE Retira do arquivo os registros apagados e os registro com
conta vazia (Todos os Saldos säo nulos).
-PT Apaga os movimentos já mostrados do arquivo de transferên-
cia.
-R Cria o arquivo ACCOUNTS.LST com a lista de usuários do
RATB.
-S[+|-]<n> Ordena o arquivo: + = ordem crescente (Default) {+}
- = decrescente
Critério para ordem n = 1 - Nome
2 - Tempo
3 - Kbytes
4 - Créditos
5 - SobreNome
Na ordenaçäo os Usuários marcados como escondidos (Hidden), seräo co-
locados no início do arquivo. Esta opçäo está disponível somente na
versäo registrada.
Se näo passado nenhum parâmetro, o RATBEDIT entra no modo interativo,
nele pode-se consultar/alterar/apagar/etc. As funçöes possíveis no mo-
do interativo säo:
F1 Mostra a tela de Ajuda.
ALT-C Converte os nomes dos usuários para minúsculas, esta op-
çäo é somente útil caso você tenha o arquivo de contas
da versäo anterior, onde os nomes eram gravados em
maiúsculas.
ALT-D Apaga registro.
ALT-I Inclui uma nova conta.
ALT-P Retira registros apagados do arquivo.
ALT-S Ordena o arquivo.
ALT-T Reinicia o movimento diário do usuário.
ALT-U Recupera registro apagado.
Direita e
Esquerda Movimentam o cursor entre os campos.
Cima e
Baixo Movimentam o cursor entre os registros.
[Enter] Edita o campo atual.
ESC Retorna ao sistema operacional.
F Marca o usuário como 'Free', com isso seus limites näo
säo Verificados. (Exceto os limites da Conta)
L Marca o usuário como 'Locked', com isso ele é impedido
de entrar no RATB, funciona como se o nome do usuário
estivesse no RATB.BLK (Descrito adiante)
H Marca o usuário como 'Hidden', com isso ele näo aparece
na listagem. (Exceto para o SysOp)
X Indica que o usuário está usando o menu em modo Expert.
ATENCAO: Näo é possível alterar a conta de um usuário quando ele esti-
ver conectado.
11
DESCRICAO DOS ARQUIVOS QUE COMPOEM O SISTEMA
──────────────────────────────────────────────────────────────────────
RATBCFG.COR
Este arquivo contém a configuraçäo de cores do RATBCFG.
Se desejar editá-lo segue abaixo a descriçäo do conteúdo de cada uma
das linha:
1a. Linha - > Cor da Janela
2a. Linha - > Cor da Borda da Janela
3a. Linha - > Cor to Título
4a. Linha - > Cor Atualizada na Entrada de Dados.
Na falta de valores em qualquer linha será assumido 07 (Branco).
RATB.BLK
É um arquivo texto, que deve ser editado com qualquer editor ASCII. Se
o nome de um usuário estiver nele entäo esse usuário näo terá acesso
ao RATB e será mostrado o arquivo TBBLACK.A?? ou o texto 39 do arquivo
de linguagem.
Exemplo do RATB.BLK:
BATMAN
Com isso o usuário BATMAN näo poderá entrar no RATB e receberá os de-
vidos avisos.
12
ARQUIVOS PARA AVISOS
──────────────────────────────────────────────────────────────────────
Todos arquivos abaixos podem ser criados em três versöes:
ASCII (.ASC), ANSI (.ANS) e AVATAR (.AVT), neste último caso desative
qualquer tipo de compressäo (Caso você use o AVTCONV chame-o com o pa-
râmetro /r-).
Em todos eles podem ser utilizadas as variáveis @COMMAND@ e os atribu-
tos @Xnn do PCBoard; e os códigos de controle ^Kx e ^Fx do RA.
Todos os arquivos abaixo podem utilizar o código de controle ^K]nnn
para mostrar textos da linguagem selecionada, onde nnn é o número do
texto.
BBSFIRST.A?? : Caso o usuário tente usar o RATB e näo tenha usado o
tempo mínimo entäo será mostrada esta tela ou entäo o
texto 68 do .RAL
BYE_RATB.A?? : É mostrado toda vez que o usuário desconecta de dentro
do RATB. Caso näo exista será mostrado o GOODBYE.A??.
RATBHLP.A?? : Este Arquivo deverá conter o HELP para o RATB, caso näo
exista será mostrado o RATB.HLP
RATBMNU.A?? : Arquivo onde deverá estar o menu a ser utilizado pelo
RATB, quando em modo normal. (Veja Personalizando seu
Menu)
RATBMNUX.A?? : Arquivo onde deverá estar o menu a ser utilizado pelo
RATB, quando em modo expert. (Deve ser um menu reduzido
).
TBINSUF.A?? : Caso o usuário näo tenha tempo suficiente para utilizar
o RATB será mostrado este arquivo ou entäo o texto 11
do .RAL
TBLEVEL.A?? : Caso o usuário näo tenha o nível mínimo para entrar no
RATB será mostrado este arquivo ou entäo o texto 36 do
.RAL
TBBLACK.A?? : Se o nome do usuário estiver no arquivo RATB.BLK (black
list) entäo ele näo terá acesso ao RATB e será mostra-
do este arquivo ou o prompt 39 do .RAL
- Nota Sobre a Tela de Apresentaçäo do RATB:
A tela de apresentaçäo aparece todas as vezes que o usuário entra no
RATB quando a versäo näo é registrada, e somente na primeira vez que
ele entrar se o RATB for registrado.
13
INSTALACAO
──────────────────────────────────────────────────────────────────────
Existem três tipos de instalaçöes, a seguir é descrito cada uma delas.
Instalaçäo do RATB pela primeira vez no RA:
- Criar um diretório para o RATB
É dado como exemplo a configuraçäo em um diretório somente para o
RATB, mas você pode colocá-lo em qualquer diretório.
Entre no diretório do RA (CD\RA) e depois crie um diretório para o
RATB (MD RATB).
- Descompacte o arquivo RATB_100.ARJ
Utilize o descompactador ARJ: ARJ E RATB_100 C:\RA\RATB
- Execute o configurador RATBCFG
Para configurar de uma lida na descriçäo do RATBCFG, onde é constam
todos os itens de configuraçäo.
- Coloque a opçäo Time Bank em algum dos seus menus
No diretório do RA (CD\RA) execute o Editor de Menus do RA (RACONFIG
-M).
* Escolha o Menu onde você quer colocar a opçäo, geralmente escolhe-se
o Menu onde estäo os outros programas externos (doors).
* Escolha a linha onde você quer colocar a opçäo, tecle <INS> e apare-
cerá uma linha em branco.
* Tecle [Enter] para editá-la. (Veja tela com explicaçöes na página
seguinte)
- Crie no diretório do RA (C:\RA) o arquivo RATB.BAT (Pode-se usar o
comando COPY CON RATB.BAT)
O conteúdo do RATB.BAT deverá ser o seguinte:
CD\RA\RATB
RATB
(Para finalizar caso tenha usado o COPY tecle Ctrl-Z)
- Edite e configure o seu EAGLE.CFG (As instruçöes de configuraçäo es-
täo no próprio arquivo, para editá-lo basta usar um editor ASCII).
- Defina a variável EAGLE com o nome do diretório e nome do arquivo
onde se encontram as configuraçöes:
Coloque no seu AUTOEXEC.BAT ou no seu BBS.BAT a seguinte linha:
SET EAGLE=C:\RA\EAGLE.CFG
Se o seu EAGLE.CFG näo estiver no diretório do RA (C:\RA) é só mudar
a linha acima para seu diretório. Se você desejar trocar o nome do
arquivo, troque no seu AUTOEXEC.BAT também.
14
INSTALACAO
──────────────────────────────────────────────────────────────────────
╒════════════════════════════════════════════════════ Edit Menu Item ╕
│ │
│ 1 2 3 4 5 6 │
│ 123456789012345678901234567890123456789012345678901234567890123456 │
│ ^[B]^ Banco de Tempo │
│ │
│ *C /C C:\RA\RATB.BAT*M │
│ │
│ Action Execute sub-program (Type 7) (a) │
│ Display (b) │
│ OptData (c) │
│ HotKey B │
│ AutoExec No │
│ Colour Colour example │
│ │
│ MinSec 20 TimeUsed 0 FlatCost 0 │
│ MaxSec 0 TimeLeft 0 TimeCost 0 │
│ A flags -------- Age 0 Terminal Any │
│ B flags -------- MinSpeed 0 Nodes │
│ C flags -------- MaxSpeed 0 Groups │
│ D flags -------- Credit 0 DayTimes │
│ │
│ │
╘════════════════════════════════════════════════════════════════════╛
(a) Indica o que o RA deverá fazer: Executar um Sub-Programa
(b) Indica o que será escrito no menu
(c) Deverá conter o nome do sub-programa a ser chamado. *C é o path do
COMMAND.COM que deve ser chamado sempre que um arquivo BATCH vai
ser executado. O *M é para fazer o SWAP da memoria para disco.
Para informaçäo sobre o resto do itens demonstrados, consulte o seu
manual do RA. Se você näo for fazer Shell para o DOS de dentro do
RATB, provavelmente o *M será desnecessário.
Instalaçäo do RATB pela primeira vez sobre o PCBoard:
- É necessário carregar um FOSSIL driver para o funcionamento do RATB
(Futuras versöes iräo ter rotinas internas para gerenciamento da co-
municaçäo serial). Os FOSSIL drivers mais conhecidos säo o BNU e o
X00, o RATB foi testado com o X00 mas o BNU näo deve apresentar pro-
blemas.
Exemplo:
(X00.SYS / X00.EXE säo os arquivos do FOSSIL)
- Colocar no CONFIG.SYS:
DEVICE=X00.SYS E
ou
No AUTOEXEC.BAT:
X00.EXE E
(Por favor, näo carregue-o duas vezes ! :-))
15
INSTALACAO
──────────────────────────────────────────────────────────────────────
- Criar um diretório para o RATB
Entre no diretório de DOORS do PCBoard (CD\PCB\DOORS) e depois crie
um diretório para o RATB (MD RATB).
- Descompacte o arquivo RATB_100.ARJ
Utilize o descompactador ARJ: ARJ E RATB_100 C:\PCB\DOORS\RATB
- Escolher o diretório onde seräo criados os LOGs
Colocar no AUTOEXEC.BAT ou no seu "batch" do BBS a definiçäo da va-
riável LOGPATH (SET LOGPATH=C:\PCB\DOORS\RATB), neste exemplo os
LOGs seräo criados no próprio diretório do RATB, mas você pode colo-
cá-los em qualquer diretório, bastando para isso trocar o C:\PCB\
DOORS\RATB pelo diretório de sua preferência.
- Execute o configurador RATBCFG
Para configurar de uma lida na descriçäo do RATBCFG, onde é constam
todos os itens de configuraçäo.
- Configure no PCBoard para rodar o "batch" RATB.BAT
Näo é necessário DOOR.SYS nem USERS.SYS, näo desative a criaçäo das
variáveis de environment: PCBDIR e PCBDAT
- Crie o arquivo RATB.BAT (Pode-se usar o comando COPY CON RATB.BAT)
O conteúdo do RATB.BAT deverá ser o seguinte:
@ECHO OFF
CD\PCB\DOORS\RATB
RATB.EXE %1 %2 %3 %4 %5 %6 %7 %8 %9
(Para finalizar caso tenha usado o COPY tecle Ctrl-Z)
Este será o BATCH de uso do RATB.
UPGRADE de versöes anteriores:
ATENCAO:
Os Arquivos de Versöes Anteriores a Versäo 0.80 Näo Säo Compatíveis,
para torná-los compatíveis retire na Eagle BBS ou na Prisnol BBS o ar-
quivo RATBUPG.ARJ para efetuar esta instalaçäo sem perder sua configu-
raçäo e seu arquivo de contas.
- Rode o CONVCFG.BAT para converter o arquivo de configuraçäo, uma vez
que os arquivos de Contas säo do mesmo formato deverá estar tudo
funcionando.
Após isto pode-se deletar o programa 0__to100.EXE e o CONVCFG.BAT.
NOTA SOBRE LOGs:
Caso a variável de environment 'RA' esteja definida, o Log do RATB
será gerado no próprio Log do RA (no formato do RA). Caso contrário
será gerado um Log próprio no diretório apontado pela variável de
environment LOGPATH.
16
PERSONALIZANDO SEU MENU
──────────────────────────────────────────────────────────────────────
O RATB irá procurar no diretório corrente pelos arquivos RATBMNU.A??
caso encontre-os irá mostrá-los ao invés de mostrar o menu padräo.
Os arquivos RATBMNU.A?? säo arquivos texto, que säo processados e mos-
trados, o programa interpretará os formatos ASC/ANS/AVT.
No arquivo poderäo ser usadas macros (códigos de controle), onde o
programa substitui pelo valor corrente, quando os encontra. Essas ma-
cros possuem uma formataçäo, para poder ser criado algum tipo de menu
com janelas e etc.
Abaixo segue a lista de macros:
Macro Substituto
───── ─────────────────────────────────────
%A Nome do usuário (40 caracteres)
%z Nome do usuário (tamanho variável)
(Todos os próximos campos tem 5 caracteres e estäo alinhados a direi-
ta.)
%B Tempo restante
%C Limite de Download
%D Créditos disponíveis
%E Tempo depositado na conta
%F Kbytes depositados na conta
%G Créditos depositados na conta
%H Tempo depositado (hoje)
%I Depósito de Tempo máximo por dia
%J Kbytes depositados (hoje)
%K Depósito de Kbytes máximo por dia
%L Créditos depositados (hoje)
%M Depósito de Créditos máximo por dia
%N Tempo Retirado da conta (hoje)
%O Retirada de Tempo máxima por dia
%P Kbytes retirados da conta (hoje)
%Q Retirada de Kbytes máxima por dia
%R Créditos retirados da conta (hoje)
%S Retirada de Créditos máxima por dia
%T Transferência de Tempo (hoje)
%U Limite de transferência de Tempo por dia
%V Transferência de crédito (hoje)
%W Limite de transferência de Crédito por dia
%X Tempo comprado (hoje)
%Y Limite de compra de Tempo por dia
%Z Custo do Tempo para compra
%1 Kbytes comprado (hoje)
%2 Limite de compra de Kbytes por dia
%3 Custo do Kbytes para compra
%4 Créditos comprados (hoje)
%5 Limite de compra de Créditos por dia
%6 Custo do Crédito para compra
%8 Valor de Kbytes transferidos no dia
%9 Limite diário de Kbytes para transferência
17
PERSONALIZANDO SEU MENU
──────────────────────────────────────────────────────────────────────
%! Limite máximo de Tempo na conta
%@ Limite máximo de Kbytes na conta
%# Limite máximo de Créditos na conta
Todos os próximos campos tem 20 caracteres e estäo alinhados a esquer-
da:
%a - %o Opçöes disponíveis para movimentaçäo de conta.
%p - %v Opçöes para SysOp, listagem de contas e saída do RATB.
Estas opçöes säo carregadas na forma de tabela portanto as opçöes para
SysOp podem ser inseridas no meio das outras opçöes que seräo substi-
tuidas por elas caso o usuário näo tenha nível de SysOp.
Para que elas fiquem fixas em determinada posiçäo, e apareçam para to-
dos os usuário (embora näo estejam disponíveis para uso) você pode
usar a macro ^K]nnn onde nnn é o número do texto no arquivo de lingua-
gens.
18
ARQUIVOS DE LINGUAGEM
──────────────────────────────────────────────────────────────────────
O RATB irá procurar inicialmente pelo arquivo referente a língua sele-
cionada pelo usuário no BBS, e caso näo encontre ele irá procurar o
RATB.RAL, exemplo:
O usuário FULANO tem selecionado a linguagem 2 que no RA do BBS onde
acessa representa PORTUGUES, entäo quando ele entrar no RATB, será
procurado o arquivo RATB2.RAL, onde deveräo estar os textos em língua
portuguesa.
Se näo for encontrado este arquivo será mostrado o RATB.RAL que é o
arquivo DEFAULT em inglês, este RATB.RAL näo pode ser modificado.
Para informaçöes de como criar novas línguas no RATB, vá ao manual do
EAGLANG, lá esta descrito todo o processo.
Caso o RATB näo seja registrado além da língua original ele aceitará
somente a língua número 1.
A cópia registrada fica limitada somente pela quantidade de línguas
suportada pelo BBS. {+}
19
CONSIDERAÇÖES FINAIS
──────────────────────────────────────────────────────────────────────
Este programa obedece as leis de SHAREWARE, ou seja, você pode utili-
zá-lo num período de 30 dias como teste e se ficar satisfeito, envie o
seu pedido de registro.
As informaçöes de como se registrar estäo no arquivo REGISTER.FRM
Este programa näo oferece qualquer tipo de garantia, exceto a de seu
funcionamento nas condiçöes descritas no manual, näo podendo ser cul-
pado por qualquer perda que venha a causar. Você o usa a seu risco.
Sempre que houver modificaçöes na estrutura do RA ou do PC-Board, que
comprometam a funcionalidade do programa, uma nova versäo do RATB es-
tará disponível para File Request na Eagle BBS, na mesma semana em que
o RA se tornar disponível.
Se você encontrar algum BUG ou quiser enviar alguma sugestäo, sinta-se
a vontade de enviar um NET-MAIL para:
Eagle BBS - Ivan F. Martinez
(011) 753-6682
Velocidade:1200/2400
FidoNet 4:801/6
24 Horas
Endereço:
Av. Três, 655 - Parque Los Angeles
CEP 09750
Säo Bernardo do Campo - SP
Brazil
20